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Overview of RSTS/E V7.8 


INTRODUCTION 


RSTS/E V7.8 is a majoc feature release of the 
operating system. Performance improvements, enhanced 
functionality, and new hardware support have been 
{ncluded while maintaining upward compatibility with 
previous versions of the RSTS/E operating system. 


° Have you been concerned with long task build 
times? : 


o Have you been concerned by disk 1/0 throughput 
time? 


f) Have you been concerned with the 65K block 
Jimitation for Eiles? 


oO Have you been concerned with COBOL performance? 


° Have you been concerned with the limitations of 
BACKUP? 


RSTS/E V7.9 addresses all of the above and more. 


This module covers the major features of RSTS/E 
V7.8 st a conceptual level. The modules that follow 
address these new features in more detail. 
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this page is for notes. overview of RSTS/E V7.8 
NEW HARDWARE SUPPORT 
Disks 
1, RLO2 
o Up to 4 ALAL/RLO2 disks on a system 
2. RxXG2 - Lloppy disk 
° Double or single density usec selectable 
° Single density is AX81 compatible 
o Uses RXB1-K diskettes 
fo) DMA access device 
° Supported as non-file structured device only 
° Up to 8 RXB1L/RXB2 diskettes on a system 
° Improved diagnostic capability 
“ M Ml ; 
ovAr-2 COMPANY CONFIDENTIAL ovn-3 Sioatas: eae RENAL 


OISITAL RSTS/£ UPSATE eres RITS/E UPDATE 
OVERVIEW OF RASTS/E V7.0 : OVERVIEW OF FETS/E V7.8 


Table OVR-1. Disk Characteristics : Terminals 


j RXO2 
DOUBLE DENSITY 


DISK NAME RxO2 


SINGLE DENSITY 


DISK TYPE CARTRIDGE | DOUBLE DENSITY SINGLE DENSITY 
FLOPPY 
No. of Surfaces/disk 1 
No. of Blocks/disk 1782 
No. of Words/disk 128K 
Device Clusters! ze N/A 
Max. Ho. of Drives 8 
Access Time 109 Average - Average 
Mi11i- 262 463 
seconds Mi lliseconds MElliseconds 
Transfer Time 3.9- Peak Peak 
words/mi- | 62kb/ 31 kb/ 
second second 


crosecond 


Figure OVR-1. LA34-DECwriter IV 


° £LA36 equivalent 
° Up to 308 baud 
° Up to 220 columns (depending on print size) 


° Set up mode allows user selectable terminal 
functions 
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LA129 - DECwriter LIL Keyboard 
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Figure OVR-$S. LAI2@ Operator Reference Card (page 1 of 2) 
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VT52 replacement 


Suppocted in VT52 mode 


Up to 9688 baud 


Sereen 
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vTlea 


- 132 columns x 14 lines 
- 8@ columns x 24 lines 


Set up mode allows user selectable terminal 


functions 


Advanced video option Includes: 


- 132 columns x 24 lines 
- Ability to combine attributes 
- Full terminal capability 
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ADDITIONAL VT16@ DOCUMENTATION 
Definition of Bach VTI08 Set-Up Feature 
This section describes each SET-UP feature in detail 


(fn alphabetical order} and states how each feature affects 
the terminal. 


Note 


Unless otherwise stated, entering SET-UP 
mode and changing features does not 
result In the loss of data displayed on 
the screen, 


ANSI/VT52 Mode 


The vridd terminal Js compatible with two different 
programming standards - American Natfonal ‘Standards 
Institute (ANSI) and VT52. In ANSI mode, the VT100 will 
generate and respond to coded sequences per ANSI standard 
X3.41 - 1974, In VTS2 mode, the VT1@0 terminal is 
_ Compatible with previous DIGITAL software using the VT52 

video terminal, : 


Answecback Message 


The VT1@0 answerback faatuce provides the terminal with 
the capabllity to Identify itself to the host. Answerback 
is a question and answec sequence where the host computer 
asks the terminal to identify itself. The terminal sends 
its untque identifier, or answerback message, to verify the 
identity of the terminal. The entire answerback sequence 
takes place automatically without affecting the screen or 
requiring operator action. 


Auto Repeat 
The auto cepeat feature allows a key to be 


automatically cepeated at the rate of about 3@ characters 
per second when the key Is held down for more than one-half 
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second. The auto repeat feature affects all keyboard keys 
except the following: 


SET-UP 

Esc 

NO SCROLL 

TAB 

RETURN 

ENTER 

CTRL and any key 


Auto XON/XOFF 


The VT10@ Is capable of automatically generating 
synchronizing codes XON [DC1l) and XOFF {(DC3}. The XOFF 
control sequence Is used to stop the transmission of data 
from the computer to the terminal; the XON sequence is used 
to resume transmission. With the feature enabled, the vT100 


will automatically generate the XOFF code when one of the 
following events occur: ; 


1. The internal buffer is nearly full 

2. The NO SCROLL key fs pressed 

3. The terminal its placed in SET-UP mode 

When either the buffer empties, the NO SCROLL key Is 
pressed again, or the terminal fs taken out of SET-UP mode, 
the VT1900 will automatically transmit the XON code to resume 
tranamission from the computer to the terminal. 


If the host computer software does not support the 
XON/XOFF codes, data sent during buffer full conditions, or 
when the terminal is in SET-UP mode, will be lost. 


Note 


The VTl1@@ will always stop transmission 
when an XOFP (DC3) code is recelved and 
will resume transmission when an XON 
(DC1) code is received, regardless of the 
AUTO XON/XOFF feature setting. 
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Bits Per Character 


This featuré allows the terminal to transmit and 
receive 7 or 8-bit characters, In most cases, the terminal 
wlll be set for ?-bit operation (normal ASCII standard 
chacacters). In those cases where the communication 
protecol requires 8-bit characters, bit 8 is set to a space 
for @} for characters transmitted and Is ignored on all 
characters recelved. 


Characters Per Line. 


The vT108 is capable of displaying either 86 or 132 
characters per line. Im the 8@ character per line mode, the 
screen !s 88 characters wide by 24 lines high. In the 132 
character per line mode, the screen fg 132 characters wide 
by 14 lines high. In the 132 character per line mode, the 
displayed lines are physically the same width as in the 8@ 
charactec per line mode, but the characters are more 
compact. 


Note 


when changing from an 88 to 132 character 
per line mode or vice-versa, the current 
contents of the screen aré lost. ‘ 


Cursor 


The vTle@ offers a choice of two cursors to Indicate 
the “active positions" or where the next character will be 
placed on the screen. The cursor may be displayed as either 
a blinking underline (_) of a bilnking block (m). 
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Interlace 


Interlace changes the scanning rate of the screen to 
allow for alternating scans of odd and even rows In the 
character. This feature is used for high resolution memory 
options. When in the alphanumeric mode, the interlace 
feature should be turned off since the use of the smooth 
scroll feature with the Interlace feature may cause the 
display to appear jittery and difficult to read when the 
screen Is scrolling. 


Keyclick Tone 


The keyclick is a tone which is generated every time a 
key fs pressed. The keyclick may be turned on or off to 
sult the operator's needs. However, research and experience 
has shown that an opecator is more accurate when there Is an 
audible feedback from the keyboard. 


Like the bell tone, tha keyclick volume Is not 
adjustable. 


LINE/LOCAL 


The LINE/LOCAL feature allows the operator to easily 
place the terminal In either an ON-LINE or LOCAL (off-line) 
condition. When the termtnal Is on-line (the keyboard 
ON-LINE indicator is ON) all characters typed on the 
keyboard are sent directly to the computer and messages from 
the computer are displayed on the screen, In the LOCAL 
condition (the keyboard LOCAL indicator is ON), the terminal 
is alectrically disconnected from the computer, messages are 
not sent to or cecelved from the computer, and characters 
typed on the keyboard are echoed on the screen directly. 


Margin Bell 


The margin bell feature Is much the sane as the bell In 
a typewriter. When the cursor is eight characters from the 
end of the current line, the VTi6@ sounds a tone to alert 
the operator. 
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New Line 


The new line feature enables the RETURN key on the 
terminal to function like the RETURN key on an electric 
typewriter. When the new line feature is enabled, pressing 
the RETURN key generates the carriage return (CR) and line 
feed (LF) codes. When a line feed code is recelved, the 
code 1s Interpreted as a carriage return and line feed. 


When the new line feature Is disabled, the RETUAN key 
generates only the CR code; an LF code causes the terminal 
to perform sa line feed only. : 


Note 


If double lfne feeds occur consistently, 


tucn this feature off since the computer 
is already performing this function 
automatically. . 


Parity 


When enabled, parity checks for correct data 
transmission. 1£€ a transmission error occurs, the VT18@ can 
detect ft and Indicate its presence by placing .a 
checkerboard character {23%:) on the screen in place of the 
character with the error, The parity sense feature 
determines if the parity is even or odd. 


Parity Sense 


The parity sense feature defines which of the two 
methods of parity checking, odd or even, Is being used by 
the vTlag. If the parity feature is on, the terminal's 
pacity sense must be matched to the parity the computer Is 
sending. I£ the parity sense features do not match, every 
character sent to the computer will be rejected even though 
the character was received correctly by the, VT190. Tf a 
pacity Incompatibility occurs, the checkerboard character 
will be show on the screen in place of the received 
character. 
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q 
Note | 


If the pacity feature is turned off, the 
parity sense selection will be totally 
dlsregarded. 


Power 


During the initial installation, the terminal display 
must be synchronized to the power line frequency. In the 
U.S. this ts set to 60 hertz, 


Recelve Speed 


The receive speed determines how fast the characters 
sent by the computer can be accepted by the terminal. The 
VT106 is capable of receiving at any one of the following 
preselected speeds: 59, 75, 116, 134, 158, 200, 300, 600, 
1288, 1600, 2000, 2290, 3608, 4806, and 9690 baud. 


The receive speed is independent of the transmit speed; 
the terminal may receive data at one speed and transmit data 
at a totally different speed. 


Screen Background 


The screen background feature of the VT100 allows the 
operator to determine the background of the screen. In the 
formal screen mode, the display contains light characters on 
a dark background; in the reverse screen mode, the display 
Contains dark characters on a light backqround,. 


Screen Brightness 


Unlike most video terminals, the VT10 does not contain 
switches of knobs to adjust screen brightness. Instead, the 
VT160 electronizally controls the screen beightness, Tnis 
feature eliminates the high failure rate of mechanical knobs 
and allows the operator to select the desired level of 
brightness for aaxinum comfort under varied lighting 
conditions. TNis Setting may be Saved like any other 
festare in the terminal. 
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Scroll 


Scrolling is the upward of downward movement of 
existing lines on the screen to make room for new lines at 
the bottom or top of the screen. It can be performed in two 
ways: jump scroll or smooth seroll. In jump scroll mode, 
new lines appear on the screen as fast as the computer sends 
them to the terminal. At the higher baud rates, the data is 
very difficult to read due to the rapid upward movement of 
the lines. In smooth scroll mode, a Limit Is placed on the 
Speed at which new lines of data may be sent to the 
terminal. The upward movement of lines occurs at a smooth 
steady rate allowing the data to be read as [it appears on 
the screen. 


Note 


Smooth scroll mode allows a. maximum of 
six lines of data per second to be added 


to the screen. The Auto XON/XOFF feature 
must be enabled and supported by the host 
computer to ensure that data is not lost 
when smooth scroll mode is enabled. 


Tabs 


Just like a typewriter, the VT108 can jump or tab to 
ceselected points on a line. These tab stops may be 
fndividvally changed, or totally cleared and then reset. 


Transmit Speed 


Transmit speed determines how fast the characters will 
be sent from the terminal to the computer. The vT1lea is 
capable of transmitting at any one of the followlng 
preselected transmit speeds: 54, 75, 110, 134, 158, 200, 
300, 600, 1200, 1800, 2986, 2488, 3606, 4800, and 9698 baud. 
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Transmit speed {s Independent of receive speed; the 


terminal may transmit data at one speed and receive data at 
a different speed. 


Wraparound 


The wraparound feature removes the maximum limit on the 
number of characters that may be entered for one line. When 
this feature is enabled, the 8lst or 133rd charactec 
(depending upon the line size selected) typed on a line is 
automatically placed in the €irst character position of the 
next line without a carriage return (CR) and a line feed 
(LF) code is generated. If£ the wraparound feature was not 
enabled, the 8lst or 133rd character and all following 
characters would be overwritten into the last character 


position of the current Line until a CR and an LF code are 
generated. 


Note 


Since wraparound is a VT10@ terminal 


feature dealing with physical lines, the 
CR and LF codes must still be generated 
to end the logical line. 


1t 
3] (shifted) 


The VT108 contains character sets for the U.S. and the 
United Kingdom. The difference between the two charactec 
sets {1s one character, the ¢ or & symbol. When the U.S, 
character set [is selected, the uppercase 3 key on the main 
keyboard displays the t character. The £ character is 
displayed when the U.K. character set is selected. 
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Figure OVR-8. TUS8 - DECtape II 


om o Low cost tape cartridge 
o Random access to 512 blocks of 512 bytes each 
° 10 second average access time 
Figure OVR-7. TSO4 (.) Up to 2 drives per controller 

to) Up to 4 controllers/8 units on a system 

o 9-track magtape tape : o Uses a DLIIA terminal intecface 

o 8080 of 1608 BPI preset at factory KMCY1 
° A microprocessor used ty the 327] packajze 

m 
9 Up to 8 units on a syste ° Up to 16 allowed on a systen 


‘ 
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NEW OPERATING SYSTEM PEATURES 


System generation option 

Data Elles limited only by the size of a disk 
Resource cost 

oe 2K words in monitor 

o One additional small buffer for each file 


opened, no additional buffers for multiple 
opens of the same file. 


RCI1 ~ fixed head disk Large files 
LK11 - hacdware which forced device Interrupts ; : 
1. 
2. 
3. 
i 
4. 


Benefits include: 


o Extension of non-contiguous files opened for 
update/write-shared access 


o Access to non-file structured disk by block 
rather than device cluster number 


@ Some performance improvement 


Data Caching — 1 


1. 


2. 


3. 
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System generation option 


Data, as well as directories, can be cached in 
memory 


User selectable random or sequential data caching 
(peivileged operation) 


Resource cost 


o Minimum 2K words of XAUF 
C) Heavier CPU usage 


Benefits 


° Overall I/0 throughput Improvement on disk 
bound systems 
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ASX Directives In Monitor 
1. System generation option 


2. User jobs do not have the RSX Run-Time System as 
part of the user virtual space. 


3. Resource cost 
o 1K words in the monitor 
A 


4. Benefits 


o 31K word user space when using the RSX Run-Time 


System 
eo 24K word user space when using RMS resident 
libeacy 
Resident Libraries ; * 


1. System generation option 


2. RMS routines memory resident and shareable by 


multiple users, 


3. Recommended for systems with a minimum of 124K 
words and applications that use RMS-11K. & 


4. Resource cost for RMS Resident Library 


o Up to 24K words of physical memory 
o 8K words in user virtual space 
° RSX directives in the monitor are required 


5. Benefits for RMS Resident Library 


Reduced task build time 

Smaller task Images on disk 

Faster executlon speed - reduced overlaying 
Overall performance improvements on systems 
with RMS-11 applications — : 


aoco9 
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User Logical Assignments with PPN's 


1, Logical assignments that associate a device and PPN 
wlth the logical assignment 


2. Benefits 
° Less programming restrictions 
3. Limitations 


o Only three logical assignments available if a 
PPN is included 


Placed Files 


1. Piest block of a File can be positioned at oc near 
a specified physical disk location. 


2. Benefits 
o Optimal placement of files to minimize head 
" movement on disks 
Tentative Files 


1. Files can be created without becoming permanent 
until closed. 


2. Benefits 
° Lass program code 


o Data security in case of a program abort or a 
system crash 


Conditionally Contiguous Files 


1. Files are created contiguous of non-contiguous, 
based on available disk space. 
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Benefits 


o Less error handling overhead 


No File Supersede 
1. Files opened for output return an error if a file 
with the same namé@ already exists 
2. Benefits 
° Less program code 
o Greater flle protection 
Zero a Disk Pile 
1. Wull characters are written over the specified ffle 
{£ it ts explicitly or implicitly deleted. 
2. Privileged operation that can be specified at open 
time - : 
3. Benefits 
o Sécurity for files containing sensitive 
information ; 
4. Limitations. 
o This operation on large files can be very time 
consuming. 
Make a Contiguous Pile Non-Contiguous 


1. 


2. 


Contiguous Files can be made non-contiguous while a 
flle is being accessed by multiple users. 


Benefits 


o Ability to extend a contiguous file white 
application programs are executing 


OVA-26 COMPANY CONFIDENTIAL 


Libcary 
1. 


2. 


CLTS7E UPLATE 
OVERVIEW OF RSTS/E V7.2@ 


Segmentation 


Utility programs and thelr associated files can be 
stored in accounts other than {1,2) . 


Benefits 


(.) Faster access to utility programs 
° Reduced overhead on the system library account 


ANSI Magnetic Tape Support 


ae 


2. 


3. 


Multi-volume magnetic tape support through PIP.SAV 


only. 


Benefits 


° Transpoctabllity of RMS-11 Sequential files 


between RSTS/E and VAX or ASX-LIM 


o Allows selective backup of large Elles to tape 
‘Limitations 


© RMS-11 Relative and Indexed filles transportable ° 


only to other RASTS/E systems 


BASIC~PLUS-2 Only Systems 


1. 


2. 


BP2COM can be installed as the system default 
run-time system. 
Benefits 


° Urility programs as task Images 


° Less memory used foe the 


system default 
run-time system 


Limitattons 


o No Immediate mode 
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COBOL Only Systems 
1. RSX Is the system default run-time system 


2. Benefits 
o No need for BASIC-PLUS or BASIC-PLUS-2 


o No need for RMS-11 Run-Time System if using the 
RMS resident library 


o Utlifty programs as task images 
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UTILITY PROGRAMS 


All .BASIC-PLUS utility programs can be compiled and 
executed under BASIC-PLUS-2 without translation, 


New utilities 


1. 


2. 


3. 


5. 


SAYRES. SAV 

e Fast volume save/restore 

° Image copy of disks 

Cs) Executes stand alone or during time-sharing 
o Handles bad blocks 

Oo. On-line for unmounted disks 

° Off-line for system disk 


ONLCLN. SAV 


Cs) On-line disk clean utility 


° More thorough disk clean than the SYS call- 
clean 


MAKSIL. TSK 


o Converts task images into resident library’ 


format 


o Converts task Images or .SAV Images Into 
run-time system format 


FIT 
° Supecsedes PIPEXT.BAS 


o File transfer program for DECtape II, floppy 
disk, AT1I disks and DOS disks 


DEVTST 


° Supersedes UETP 
° Device testing package 


RMSIFC 


° Performs fast loading of. indexed files 
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Discontinued Utilities 


eo9oc000 


UETP ~ superseded by DEVTST 
SYSCAT.BAS ~ superseded by DIRECT 
PRIOR.BAS - superseded by UTILTY 
PIPSML.BAS ~ superseded by PIP.SAV 
PLX.BAS - superseded by PIP,.SAV 
PIPEXT.BAS - superseded by PIP.SAV 
ROLLIN - superseded by SAVRES 
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UNBUNDLED SOFTWARE DOCUMENTATION 

o BASIC-PLUS-2 V1.6 1. Updated/reorganized manuals 
o COBOL V4 ; 
DATATRIEVE V1.2 , © BASIC-PLUS Language Manual 
. DIBOL/DEFORM V4C and V4D o RSTS7E System User's Guide 
° RPG IT V8. 62 o RSTS/E Programming Manual 
o FORTRAN {V V2.1 o RSTS7E V7.0 System Manager's Guide 
o FORTRAN IV PLUS ¥2.5 o ASTS/E V7.6 System Generation Manual 
° ASTS/E Task Builder Manual 
~- Category C ° RSTS/E V7.0 Documentation Directory 
- No RMS Support 
2. RSTS/E Programmer's Utilities Manual 
KMC/3271 V1.8 
7 f 9 RSX based utilities manual 
o DECNET/E vi.t 
- LBR 
-~ Virtual terminal support - PAT 
: : - MAKSIL 
6 WISE - MAC 
ECAL ’ 
o «(OD 3. RSTS/E System Directives Manual 
CATEGORY € SOFTWARE © A MACRO programmer's manual 
o. APL-11 - General monitor directives 
o FORTRAN IV PLUS. - RSX emulator directives 


~ Run-Time Systems 


4. RMS-11 User's Guide 


° All RMS-11 documentation consolidated into one 
manual. 


5. RMS-11 MACRO-11 Reference Manual 
ae fterence Manual 


r) RMS-11 implementation in MACRO-1] 
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- System Generation Procedures 


CONTENTS 


INtroductlonececcnceccoccsessescceessssssererseee SYS-1 
Distribution Media.sacccsveccerscersersserasecece SYS-2 
General System Generation precedures Flowchart... SYS-5 


Enhanced INIT OptlonS.ccrecrescessceceseersresees sys-9 
DSKINT Optlon..cceccscccceccecscccrecescerseces SYS-9 
HARDAR Optlon.cecasvccececsenccrcrscsesersceee SYS-19 
REFRESH Optlon.ssccccecccsacccccesscssssererss SYS-12 
DEFAULT Optiom.csncsccccesveccecesereseseveres SYS-15 


New and Enhanced SYSGEN.SAV QuestlonS.wcccereeeeses SY5-16 
Distribution QuestionS....--sereesreceseeeeres SYS-14 
RSK QuestlonsS..ceerecveescerecsesnessssscreres SYS-17 
Terminal Service QueStlonS....eseseceeseeerers SYS-19 
Disk QuestlonSscoccccrerceveeseececsesesercrse SY¥5-20 
Peripheral Device Questlons..-seseeseeereesces SYS-21 
Optional Menitor Feature QuestlonS..-.e.-ecees SYS-24 


Programs Relating to Library Buliding...cceeeeees S¥S-26 
MINCOP Program..ssenvesacccersrrereceseecreer® SYS-26 
PATCPY PLOgramecscccerceresncsercseresrersesre SyS-298 
BUILD Program..scoccceserscncrressccncerseerrs SY¥S-32 
ATPK PLOgram.cccccecrocscesasseereesererssere? sys-37 
CSPCOM (CUSP.Compliler) Program..-sscesrerseree SyYS-44 
Autopatching Packag@..esscesssercreersrscescre SYS-45 


Example System Generatlonecscccrccesccsserceeerrs SYS-46 
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System Generation Procedures 


INTRODUCTION 


Before RSTS/E can be made available fer general 
time sharing: : 


° The monitor must be generated, 


° The default run-time system, system library, 
and optional software must be bullt, and 


o Command and control Elles must be created. 


These procedures are normally done at system 
generation time. 


With RSTS/E V7.0, the system generation procedures 
have been enhanced to allow support of: 


9 New hardware 

o New INIT features 

° New monitor features 

o New library bullding features , 


This module covers the changes and enhancements to 
system generation for RASTS/E V7.9. 
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DISTRIBUTION MEDIA 
Table SYs-1. 
DEC Order No. 


7-Track 

AP-2772G-BC 
AP~-2725G-BC 
AP-C726G-BC 
AP-C8683B-BC 
AP-D847C-BC 


AP-H46SA-8C 


9-Track 

AP-2773G-BC 
AP~2753G-BC 
AP-C725G-BC 
AP-C881B-BC 
AP-5226D-BC 


AP-H466A-BC 


9-Track 


AB-H751G-BC 


AB-H752G-BC 


AB-~H75 3A-BC 


RSTS/E UPDATE 
System Generation Procedures 


Magtape Distribution Kits 


SY¥S~2 


Contents 


System Generation 
System Library I 
System Library If 
RSX Run-Time System 
and Library 

RMS Run-Time System 
and Utbrary 

RSTS/E V7.9 Patch 
Kit 7A" 


System Generation 
System Library I 
System Library If 
RSX Run-Time System 
and Library i 
RMS Run-Time System 
and Libracy 

ASTS/E V7.0 Patch 
Kit “A 


(2489 Ft. reel) 


System Generation 
Libraries, 

RSX Run-Time System 
and Library 

RMS Run-Time System 
and Library 

RSTS/E V7.8 Patch 
Kit "A* 
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Table SYS-2. 


DEC Order No. 


RKGS 
AN-2771G-8C 
AN-2751G-BC 
AN-5444G-BC 
AN-C885B-BC 

" AN-5227D-BC 


AN-146 7A-BC 


RKO6 

AM-2774G-BC 
AM-5445G-B8C 
AM-5228C -BC 


AM-H 46 8A-BC 


RKB? 


AY-D526G-BC 


AY-D946C-BC 


AY~H469A-BC 


ASTS/E YPDATE 
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Disk Distribution Kits 


Pack iD 


SYSGNG 
SYSLI1G 
SYSL2G 
RS XLBB 
RASKIT 


PATCHA 


SYSGNG 


SYSL1B 
RMSKIT 


PATCHA 


RMSKIT 


PATCHA 


cyc-? 


Contents 


System Generation 
System Library I 
System Library If 
RSX Run-Time System 
and Library 

RMS Run-Time System 
and Library 

ASTS/E V7.9 Patch 
Kit "A" 


System Generation, 
RSX Run-Time System 
and Library 

System Libraries 
RMS Run-Time System’ 
and Library 

RSTS/E V7.0 Patch 
Kit "A" 


System Generation, 
System Libraries, 
RSX Run-Time System 
and Library 

RMS Run-Time System 
and Library 

ASTS/E V7.0 Patch 
Kit 7A" 
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Table SYS-2. 


RLOL 
AX-D527G-BC 
AX-05 286 -BC 
AX-D945C-B8C 


AX -H47 6A-BC 


DEC Order No. 


RSTS/E UPDATE 
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Disk Distribution Kits (Cont.) 


SYSGNG 
SYSL1B 
RMSKIT 


PATCHA 


SY¥S-4 


Contents 


System Generation, 
RSX Run-Time System 
and Library 

System Libraries 
RMS-Run-Time System 
and Library 

RSTS/E V7.@ Patch 
Kit "A" 
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Figure SYS-1. 


Boot * 
distribution 
media 


Inttiatize 
disks and 
copy fites 


Tellor and 
start up 
SYSGEN 
System 


fun CREATE 
and answer 
questions 


Run SYSBAT, 
shutdown 
SYSGEN System, 
and boot output 
media 


Is 
this an 
intermediate 
media? 


vy. 
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SYSTEM GENERATION PROCEDURES FLOW CHART 


Copy [0.1] files 
to terget 
disk 


Sysqen Flowchact (Page l of 4) 


com PENY CONFIDENTIAL 


DIGITAL ASTS/E UPOATE ; DIGITAL RSTS/E UPDATE 
System Generation Procedures System Generation Procedures 


Mount - 

the eppropriste 
diteibution 
media 


RUN 
SY BUILD 
ond buitd 


Run 
RSM libewsios 


OEV:SMINCOP 
Intermediate from Intermediate 
media? medis 


BASIC PLUS 2 


Build 
BASIC-PLUS-2 be the tystermn 


Mount 
the patch 


Run BUILD and 
build the 
systems 

hbeery 


Are 
there 
three disk 
delves? 


Craste 
ASC11 lee 
and 

eccounts 


Run PATCPY 
from peteh kit 
for BASIC-PLUS 


Buitd 
Auniliary 
Softwere 


for RSX 


Figure SYS-1. Sysgen Flowchart (Page 2 of 4) 
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RUN 
SHUTUP.RSX 


Make 
BP2COM 
the system 
default 


Gete 
SAVE 
tot of 
the 

system disk 


General 
Timesharing 


Figure SYS-1. Sysgen Flowchart (Page 4 of 4) 
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ENHANCED INIT OPTIONS 
DSKINT Option 


Option: DSKINT 


07-Feb-79? 
82:07 PM? 


Disk? DM@: 


This disk pack appears to be a RSTS/E formatted 
disk with the following characteristics: 


Pack ID : SYS PAK 
Pack Cluster Size : 8 
Pack is currently : Private, 


Update access date on weites. 


Pack ID? SYSPAK 

Pack clustec slze? 6 

SATT.SYS base? : 
Type a block number to locate the file SATT.SYS at a 
specific place on the disk, or type <LF> to let ASTS find a 
location. 

SATT.SYS base? 

MFD password? V790 

MED cluster sizer 16 

Pre-extend directories (ne) 7 ¥ 

PUB, PRI, or SYS? SYS * 

Library password? LIBR 

Library UFD cluster sTze? 16 

Library account base? 

Type a block number to lecate the library account at a 
specif{c place on the disk, or type <LF> to let RSTS Elnd a 
location. 

Library account base? 

Date last modiffled (no)? ¥ 

New files €irst (no)? = 

Use previous bad block Info (nce)? ¥ 

Format (no)? ¥ 

Patterns? 2 

Proceed (¥ or N)? Y 
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HARDAR Option Name Address Vector Comments 


TT: 1775608 960° 
RL 174466 158 Units: B(RLB1) Z2(RLG2) I(RLG2) 


Option: HARDWR RM: - 177440 218 Units: O(RKOA) L(RKOG) 2 (RKO7) 


RBs: 176790 254 Units: @(RPO4 DP) L(RPO4 DP} 

HARIWR suboptfon? LIST RR: 176303 150 Units: 
{RA: System Disabled) 

Name Address Vector Comments TU: 172446 224 Units: B(TUIH @TMO3 $6) L(TULG PTMG3 88) 
TT: 177558 659 : 
RL: 1744040 168 Units: O(RLO@1) 2(RLG2) 3(RLA2) KWI1L (177546 100 
RM: 177448 219 Units: @(RKG46) L(RKOS) 2(RKOT) KWILP 172546 104 
RB: 176706 254 Units: O(RP@4 DP) L(RPO4 DP} SR 177578 
RRs 176309 156 Units: DA 177578 


TUs 172449 224 Unitse B(TULS OTMA3 80) L(TUIG ETMG3 Fe) 


Hertz = 64. 
KWLIL 177546. 108 


KWIIP 172540 104 Other: Cache 
SR 177578 
DR 177578 


HARDAR suboption? EXIT 


Hertz = 68. 3 changes baling made. 


Others: Cache Rebooting ... 


HARDHR suboption? DISABLE 
Controller to disable? ARG 
HARDWR suboption? UNITS 


Disk to set units for? DB 
Unit? @ re 
Type of this unit? 
Unit? 1 : 

Type of this unit? 
Unit? 


HARDWR suboption? TU58 
DL FOR DDG (?)? 
DL FOR DD2 (7)? °2 

HARDYR suboption? LIST 


3 changes pending. 
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REFRESH Option 
Option: REFRESH 


07-Feb-7597? 
@2:27 PM? 


DISK? DM@ 
Clean? ¥ 


Disk Is being cleaned - wait ... 


REFRESH suboeption? LIST 


Pile Pile Current Minimum Start 
Name Required? Flags Status Size Size LBN 
System files: 
SWAP .SYS YES CRE : 64 
SWAP® .SYS NO OK : 
SHAPL .SYS NO OK 
SWAP3 .SYS no OK 
over SYS NO OK SA 
ERR .SYS NO - OK 16 " 
BUFP .SYS NO OK 
CRASH .SYS NO OK : 25 
Others: 
BADB .SY¥S NOD 4@ 
SATT .SYS NOO CTG : 1 13545 
INIT .SYS NOD CTG 417 
EAR «ERR CcTG 16 649 
SYSGEN.SIL HOD CTG 201 
RT12  .RTS CTG 28 897 
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REFRESH suboption? CHANGE 
SWAP.SYS changes? YES 

Size? 20*31 

Base? 13545 
SWAPS.SYS changes? 
SWAP1.SYS changes? 
SWAB3.SYS changes? 
OVA.SYS changes? 
ERR.SYS changes? 
BUFF.SYS changes? 
CRASH.S¥S changes? ¥ 

Size? 8a 


Base? 
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REFRESH suboption? LIST 


File Pile Current Minimum Start 


Name Required? Flags Status Size Size LBN 

System files: Ar. A 

SWAP .SYS YES NOD CTG OK 2489 54 13665 

SWAP®@ .SYS NO Ox 

SWAP] .SYS NO OK 

SWAP} .SYS No OK . 

OvR SYS NO OK 54 

ERR «SYS NO OK 16 

BUFF SYS NO OK 

CRASH .SYS NO NOD CTG OK 68 25 921 

Others: 

BADB .SYS NoD "ae 

SATT .SY¥S NOD CTG i 13545 

INIT .SYS NOD CTG $17 : 

EAR ERR CTG 16 649 

SYSGEN.SIL NOD CTG 201 - 

RT1i = =.ATS CTG 20 897 

REFRESH suboption? . 
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DEFAULT Option 
Option: DEFAULT 
No defaults, are currently set in SYSGEN, SIL 
You currently have: JOB MAX = 2, SWAP MAX i‘ 16K. 
JOB MAX or SWAP MAX changes? ¥ 
New JOB MAX? 2 
a New SWAP MAX? 28 
You currently have: JOB MAX = 2, SWAP MAX = 28K. 
JOB MAX oc SWAP MAX changes? 
Run Time System? RTI) 
Error message Eile? ERR 
Installation name? SYSGEN 


Memory allocation table: F 


OK: O400000G - 60127777 ( 22K) : EXEC 

22K: @0130080 - 00147777 { 4K) : RTS (RTL) 
26K: 08150600 - 90757777 ( 98K) : USER 
124%: 887500890 - End : NXM 


Table suboption? 
You currently have crash dump disabled. 
Crash dump? ¥ 
Magtape labelling default (none)? pos 
Preferred clock (P 188)? 
Date format (ALPHABETIC)? 
Time format (AM/PM)? 


Power fall delay (1)? SO 
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NEW AND ENHANCED SYSGEN.SAV QUESTIONS : : RSX Questions 


Distribution Questions 


You have the option of installing RSX of 
BASIC-PLUS-2 as the system default Run-Time System. 


The RSTS/E system is distributed on magtape, RKOS Will you want RSX as the system default Run-Time 

(DK), RL@L (DL), and RK@6 and RKG? (DM) cartridge System (Yes or No)? 

disks, oc may already have been transferred to the 

system disk (S¥). For magtape, & distinction must RSX as default RTS? not 

be made between the TU18, TE18, and TS83 drives, 

vhich use the device name "MT"; the TU16, TE16, and ! 

TUS5 drives, which use the name "MM"; and the TS@4, 

which uses the name "MS", enter the type of 

distribution medium for this system generation (MT, 

MM, MS, DK, DL, DM, or SY¥)- The system generation process can automatically 
patch the generated RSX RTS. You must have an RSX 

Distribution medium? t77¢ patch file on some ASTS/E Elle structured medium. 


Would you like to automatically patch the generated 
RSX RTS (¥ or N)? : 


RSX patching? 27% 


The RSX RTS patch flle can exist on the current 
system disk (S¥): another disk (DF, DK, DL, DM, ODP, 
DR or DB}; TULS, TE1S, cr TS03 magtape (NT); TULG, 
TE14, or TUAS magtape (MM), TSB4 magtape (MS), or 
DECtape (DT). Enter the name of the medium which 
has your RSX RTS patch file. 


Patch file medium? 
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The disk on which your patch Elle exists has a 
legical name called the pack Iidentiffecation. This 
was assigned to the disk when it was inittlallzed. 
Please specify that pack ID. 


Pack ID? 


Enter the fille name of the RSX RTS patch file. You 
may enter an sccount number (for example, [(18,23]) 
or $ (for [1,2]) along with the Elle name. 


Patch Eile name? @SRSXRTS.CMD F 
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Terainal Service Questions 


. The RSTS/E terminal service can be built to respond 


te CTRL/T by printing a one-line status report 
describing the job's status. This report Includes 
the job name, RTS name, run state, job and RTS 
sizes, and tetal and Incremental CPU times. The job 
fs not disturbed when the report is printed. Would 
you like to have this feature in your monitor (YES 
er NO)? 


One-line status report? fy! 
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Disk Questions 


The RLII controller is used to control any 
combination of up to 4 of the RLG1 2.6 million word 
or RLG2 §.2 million word top loading cartridge disk 
drives, Enter the number of RLO} and RL82 drives on 
this system (@ to 4). 


RLO1/RLE2* s? 


Overlapped Seek? eve 


The RK611L controller is used ‘te control any 


combination of up to eight RKA6 (6 million word) or 
RKO? (12 million word) top loading cartridge disk 
drives. Enter the total number of RKG6 and RKO7 
drives on this system (@ to B). 


RKOG/RKBT's? 


Overlapped seek? 


The RMG2/3 disk system consists of an RH11 
controller and up to elght RM@2 or RM@3 moving-head 
disk pack drives. Type the total number of RM@2 or 
RMO3 drives In this configuration (8 to 9). 
AMNO2/ANB3's? 


Overlapped seek? 
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pecipheral Device Questions 


The TS@4 magtape system censists of a TSI11 
controller and a TS04 drive. ASTS/E supports up to 
8 TS#4 systems. If this system has no TSO4 magtape 
drives answer @; otherwise, how many TSO4's exist on 
this system (@ to 8)? 


TS04' s? 


The TU58 DECtape - II system consists of two drives 
and a controller, connected through a DLL! 
interface. ASTS/E supports up to four TUSB systems 
for a maximum of efght drives. Please enter the 


number of TUS8 drives attached to this system (@ to 
8). 


TUSB's? 


The RX11 or RX211 floppy disk system consists cf a 
UNIBUS interface and an RxBL (single density) or 
AX82 (double density) fleppy disk subsystem. The 
RX@1 and RX@2 each Include a disk controller and twe 
floppy disk drives. RSTS/E supports up to four RXIL 
or RX211 systems for a maximum of eflght drives. 
Please enter the number of fleppy disk drives 
attached to this system (8 tc 8). 


RXOL/RXO2' Ss? 
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The KNCL1 {8s an Intelligent microprocessor 
centroller which, when loaded with apprepriate 
micre-codes, can be used to control various types of 
peripherals. How many KMC11 units do you have on 
this system {@ to 16)? : 


KMCI1' 8? 


The KMCil can emulate the operation of various 16M 
Protocols. This support permits the RSTS/E system 
to communicate with any I8M system which supports 
the protocol. De you want the KMC IBM protocol 
support (YES or NO}? 


KMC 18M protecol support? ioe 


Each KMC11L can control one DUP11 synchronous line 
interface to the 3271 host. How many simultaneous 
KMC/3271 links do you want? 


Simultaneous Links? 
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The LP driver can be made to take advantage of the 
extended buffer pool rather than always buffecing 
chsracter output frem the snall buffer pool. This 
will particularly beneflt those systems which have 
an increased contention for system small buffers. 
Do you want the extended buffering for LP (YES or 
No)? 


Extended buffering for LP? tye 
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Optional Monitor Featere Questions 


An optional feature of RSTS/E Is the ability to read 
and write files which are longer than 65535 blocks, 
Including large file support also reduces fille 
creation and access times and makes disk update mode 
significantly faster. Including large Elle support 
will make your monitor 2K larger, and will use more 
small buffers for each open file. Do you want your 
system to handle large Elles (YES or NO)? 


Large files? ivé 


An extended version of FIP buffering is available 
under RSTS/E which allows jobs to specify, on a fille 
by file basis, that user data files are to be cached 
in the extended buffer pool. This caching is in 
addition to the FIP directory buffering, Extended 
FIP buffering can also cache clusters cf data, ,and 
do read ahead of user data. It requires you to 
allocate at least 2K words to the extended buffer 


pool. Do you want to include extended FIP buffering 
in your system (YES or NO)? 


Extended data buffering? §Noe 
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At the cost of a physically larger menitor, the disk 
driverg and their subroutines can be built Into 3 
separate monitor “phase”. If you want tc maximize 
the size of your small buffer pool, you sheuld 
answer "YES". Bulld monitor with a separate disk 
driver phase (YES cr NO)? 


Disk driver phase? svt 


An optional feature of RSTS/E allows pregrams te 
reduce I/O for overlaying by attaching to sharable 
memory-resident code. If you have at least 124K 
words of memory, and intend to use the RAS-11 
resident library, answer ‘YES'. . 


Resident libraries? yt 


a 
The RSTS/E monitor can be made to take over some of 
the function of the RSX Run-Time System. Programs 
which necmally run under RSX Run-Time System dentt 
need any run-time system, so they can grow to JlK er - 
use the address space for a resident library. This 
option makes the monitor 1K larger. Do you want to 
include ASX directives In your moniter (YES or NO)? 


RSX directives? iy? 
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PROGRAMS RELATING TO LIBRARY BUILDING Programs Copied i!nto S¥:[1,2] by MINCOP 


MINCOP Program 
Table SY¥S-3. 


Program RTS 
. PIP. SAV RT11 
When an Intermediate media is created during system 
generation, the MINCOP pregram must be run to copy PIPSAV. TXT RT11 
the utility programs needed for bullding the system 
library. ONLPAT. SAV RTI 
RUN DEV: SMINCOP MACRO. SAV ATIL 
DEV: {s the device specification of the CREF.SAYV RTL 
intermediate disk or magtape. Do not specify an 
extension for the program in the RUN command. LINK, SAV aT11 
LIBR.SAV RTL 
Note 
; PATCH. SAV RTL1 
If the Intermediate media {s a disk, the 
MINCOP pregram will logically dismount PAT. SAV RTI 
the disk when the copying is completed. 
UTILTY.SAV RT11 
SYSLIB.0BJ RT11 
COMMON.MAC RT11 
PATCPY. TSK* ASX 
LOGIN. TSK* RSX 
BUILD. TSK* RSX 
ATPK.TSK* x ASX 
CPATCH. TSK* RSX 
AUTOED. TSK* RSX 
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Savea Gattvutler Gccecaiee, oF System Generation #recedures 
PATCPY Progran Table SYS-4. PATCPY 
The PATCPY pregram, executed prior to building the : Response to 
system library, transfers command and patch files from a . Packages to patch? Files copied 
patch kit to a disk. These files are used during the bulld ** 
procedure to automatically patch utility programs. RED 7 
ws EXEC EXEC.CMD 
RUN DEV: SPATCPY MONITR.CMD 
* 
The device from which PATCPY {fs run depends upon the cap 
system default run-time system, For BASIC-PLUS, PATCPY is PAGI??.* 
run from the patch kit. For RSX, PATCPY is run Erom SY: RJ2780.CMD 
PAGS?? .* 
Example PATCPY Dialogue DECNET.* 
- DECNT? .* 
RUN MMO:SPATCPY PA4S?7? .* 
PATCPY X7.9-05 RSTS V7.9-05 TIMESHARING atet roa 
Enter distribution device/PPN<MM@: [1,2] ¥: : 
Entec output device/PPN: S¥:(200,200] | M 
(Can't find Elle or account — SY¥: [28d, 208] ee oes 
Attempt to create account SY¥: (208,280} <No>? ¥ ; 
Account SY: [268,208] created with your password 
Packages to patch? BUILC ; Stee eco a 
on MMO: Hoaieniged or to SY: (208, 200)BUILD.CMD 
Copying MMB: (1,2]PA10@2.CMHD to SY: [(268,200]PA1002.CMD | R.CMD 
Copying MMO: [1,2]PA1002.001 to S¥: (208, 200]PA1002.@01 . nonere Caste 
. BASIC BASIC.CMD 
5 Elles copied Cena 
Copy operation complete RI278¢0 ??27808.CMD 
: PAAS??.*% 
PA25??.* 
DECNET DECHET.* 
DECHT?.* 
i NETSLO.* 
PA45?7.* 
PA46??.¢ 
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Table SYS-4. PATCPY (Cont.) 


Response to 


Packges to patch? 


BUILD 


SPLER 


BIGPRG 


BACKUP 


DEVTST 


RT11 


RSX 


RMS 


SORT 


Files Copled 


BUILD.CMD 
PA1O??.* 
PA11?7 .* 
PA1272.* 
PALT?7.* 
PA2218.* 


SPLER.CMD 
PA14??.* 


BIGPRG.CMD 
PA1027.* 
PALI?22.* 
PA2219,¢ 


BACKUP. CMD 
PA1327.* 


DEVTST.CMD 
PA1877.* 


RT11.CMD 
PA2272.* 


AS x.CND 
PA2172.4 
RMS .# 

PA2927.* 


SORT.CMD 
PA302? .* 
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Response to : 
Packages to patch 


*STANDARD* 


Other valid responses 


BASIC2 
FORTRAN 
DTR 

DMSS5SaA 
DIBOLVAC 
DIBOLV4D 
RPG 

APL 

WISE 
DECAL 
DECNETV1.8 
BASIC2V1.5 
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PATCPY (Cont.} 


Flles Copled 


INIT.CMD 
SYSGEN.CMD 
MONITR.CMD. 
BASIC.CMD 
RJ2Z7AG.* 
DECNET.* 
NETBLD.* 
BUILD.CHD 
SPLER.CMD 
BIGPRG. CMD 
BACKUP.CHD 
DEVTST.CMD 
UNSUPP.CMD 
RSX. CMD 
RTIL1.CHD 
RMS.* 
SORT.CMD 
PAO??? .* 
PAL??72.*% 
PA2122.4 
PA2277.% 
PA3172.4 
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BUILD Program 


The BUILD program has been re-written for RSTS/E V7.9, 
Enhancements include: 


o =«Autopatching as part of the BUILD procedure, 


° Packages (BACKUP, SPLER, DEVTST, 


and Error Logging) 
in accounts other than (1,2), 


° CUSPs build under BASIC-PLUS, RSX or BASIC-PLUS-2 
with the same set of control files, 


o Specifying 'La:" on other than Sy:f{l,1], 


° bynamtcally creating START.CTL and CRASH.CTL flles, 
an 


o Automatically ‘Apns' pati,” 


RUN DEV: SBUILD 


The device from which BUILD ts ru 
System default run-time system, 


BUILD from the distribution kit, 
from SY¥:. 


nm depends upon the 
For BASIC-PLUS execute 
For RSX, execute * BUILD 
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Example BUILD Dialogue 
RUN- MMO; BUILD 


BULLD X7.0-85 RSTS V7.9-05 TIMESHARING 
m Build <No>? YES 
Bee Input Device <MM@:/DEN: 848/PAR:0DD>? 
Library Output Device <S¥:>? 
Target System Device <SY¥@:>? 
Library Account ¢[{1,2]>? 


*** Copying fille MM@:(1,2JBUILD.CTL to BLOI. TP *** 


: ? 
logical "LB:* on <SY¥:(1,11}> 
Fanclicn 1aeiLapsee. Patch, Bulid) <Build/Patch>? 
Save patched sources el 
-Time System <BASIC> 
Saeate ERROR Package on <S¥:[1,2]>? S¥:(1,18} 


- :(1,18) 

antt find file or account SY: (1, 

Aicoae to create account SY¥:[1,10] <Ne>? i, 
Account SY:(1,10] created with your passwor 
Additional Control File is <None>? 
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Command Format for "Source Input Device?" Prompt 
[leg fllese}devs:[/switches] 
where 


legfile 


fs the Elle specification of the file {in which to 
log the bulld procedure. 
t 


dev: 

{s the actual source Input device. 
/switches 

can be any one or more of the follewings 


/DEN(SITY}:80@ OR /DEN(SITY]:160@ only valid for magtape 
/PAR(ITY]:0DD OR /PAR[ITYJ: EVEN only valid for magtape 


/DOS only valid for magtape 
7ANSI enly valid for magtape 
/DET [ACH] 


The DETACH switch causes BUILD {actually ATPK) to 
detach. Tf a legEile {is also specified, this can vastly 
Speed up scme BUILD/PATCH procedures, because it elim{nates 
time spent walting for the KB: output. 


Note 


DIGITAL recommends that the /DETACH 
switch is not used until after the 
standard CUSPs are bullt (BUILD.CTL). 


Response to Run-Time System? question must bez 


o A keyboard monitor which is present in [8,1] or is 
the current system default, : 


° A BASIC-PLUS, RSX or BASIC-PLUS-2 run-time system 
with an executable extension of .BAC or .TSK. 


SYS-34 COMPANY CONFEDENTIAL 


- RSTS/E UPDATE 
DISyIKe System Generation Precedures 


BUILD Control Files Supplied with Distribution 


BUILD.CTL Used in a system build. 
: Utilitites needed on all systems. 
BIGPRG.CTL Large Utilities 
SPLER.CTL Operater Service and Speoling utilities 
BACKUP,CTL BACKUP package 
DEVTST.CTL Device exercising package 
RMSBLD.CTL " RMS~11 package 
RSX. CTL RSX package 
TECO.CTL TECO package 
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RSX.CTL Contents 


RSX, RTS 
SYSLIB.OLB 
RSXMAC.SML 
CSPcoy4.oOLe 
TKB.TSK 
MAC.TSK 
LBR.TSK 
PAT. TSK 
EDT. TSK 
CSPCOM. TSK 
SHUTUP, RSX 
EDTCOM.TXT 
SLOTKB.TSK 
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ATPK Program 


ATPK (pronounced *at-pee-kay") is included in ASTS/E 
v7.0 for use as a part of the BUILD procedure. [It can alse 
be used as a. general purpose indirect command f}le 
processor. ATPK can control a job by use of a pseude 
keyboard (PK) and tun programs from a script previously 
defined in 8 command file. As an ind{rect cemnand File 
processor, ATPK runs at the user's keyboard and reperts the 
job dialogue there as {t happens. ATPK can also be used 38 
a simple batch processor, running detached and reporting the 
job dialogue in a log file. 


Starting Up ATPK 
ATPK may be invoked {fn one of the following ways: 


RUN SATPK 
*#<startup command> 


or, if the CCL is installed, 


ATPK <startup command> 


ATPK 
*¢startup command> 


ATPK wlll accept either of the CCL commands “ATPK* or “@° if 
they have been Installed by the system manager. 


éstartup command> {fs of the form: 
{<leg flle> =] <command Eile> {/<switches> ] 
Valid switches are: 

/DET Run ATPK detached. Note that !f a 
leg fle {s not specified, cutput 
will be to the keyvoard whether cc 
not ATPK detaches. At the end cf a 


successful detached run, ATPK will 
kill ftselfs 
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fDEL Deleta command file on successful 
completion (used by BUILD). 


/RATS2<rts> Start the controlled job under the 
keyboard menitor ¢rts>. If <rts> is 
not a keyboard monitor RTS, no ercor 
will be reported and. the new job 
will start up under the system 
default RTS. If this switch Is not 
speciffed, the job will start under 
the user's current job default RTS. 


/LOG If the user {fs privileged, logins 
will be ralsed, if necessary, to 
start the controlled job (used by 

5 BUILD). 


“{CHALIN]: <peogram> [;<line>] [(=\<core command>\]} 


On successful completion, chain to 
cpreg em at line number “lined, If 
specified, with <core common> loaded 
in core cemmon, {if specified. Any 
character net contained in <core 
common> may be used In place of the 
backslashes to delimit the ‘core 
cemmon> argument. fThia switch 
allows BUILD to patch Itself or ATPK 
and then chain back to ttself for 
the rest cf the build. 


The dlalogue ef the controlled job will normally be 
printed on the terminal. If, a leg file is specified, the 
dialogue will also be printed there. If both a log fille and 
the /DET switch are specified, the dialogue will only be 
printed In the leg Eile. 


The default extensions for the command and log files 
are, respectively .CHD and .LOG. 
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processing the Command File 


ATPK usually sends each line of the control file "35 
Ls" to the PK when the jeb at the PK enters a program or 
moniter keybeard wait stall. Four characters in the command 
fille are handled specially, however: 


$ as ficst character on line, indicates an ATPK 
command. 

1 as first character on iine, indicates a comment. 

7 indicates a control character. 
indicates that the next character Is not a special 
chacactec. (f{.e., an underscore character quctes 
the following character.) 


ATPK Commands 


-Any command flle line beginning with a dollar sign ($) 


will be considered an ATPK command. valid ATPK commands 
: . ; 


{ 
are 


SLOG OFF Turn dialegue reporting to the log 
flle (and/or keybeard) of€. 


$LOG ON Resume printing the contrelled job's 
dialogue in the log File {and/or at 
the keyboard). 


SALLOW NO ERRORS Abort If any (fatal or warning) errors 
are encountered by the controlled job. 


$ALLOW WARNING ERRORS Abort {f a fatal error Is encountered 
by the contrelled job, but allow 
warning errors. 


_$ALLOW FATAL ERRORS Do not abort {ff any errors are 


encountered by ‘the controlled job 
(default setting). 
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$@<command file> 


SDETACH 
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Accept a linge of input from the 
keyboard and send {t as input to the 
controlled job. If a program is 
running at the controlled job after 
this Line has been processed, continue 
accepting command lines from the 
keyboard until the pregram has stopped 
running and the controlled job fs In a 
keyboard monitor walt (that is, SYSTAT 
would show the job In a “°C” state). 
After this command has been processed, 
{nput will resume from the command 
fille. 


Switch input command stream to 
<command £ile>. ATPK willl abort if 
the command file is not Found. No 
nesting of these {ndlrect command 
files is allowed; ATPK will abort If 
it finds the *$@" command in the 
Ccommand file>. 


Causes ATPK to detach. This command 


may be used after the $WAIT command to 
cause ATPK to detach after user [nput 
at the start of the controlled job. 


$LOGIN [(KB{nJi] (ip,pn)] 


Log In a keyboard number n under the 
account specified by {p,pn). This 
command, which {Is only available to 
privileged users, causes ATPK to 
create. a job running LOGIN with 
Instructions to attach to the 
specified keyboard and log {in under 
the specified account. If (p,pn) Ss 
not specified, the account that ATPK 
{s running under will be used. If n 
{s not specified (for example, S$LOGIN: 
KB:), LOGIN will be Instructed to 
attach to the keyboard from which ATPX 
was started. This may be useful to 
log the user back In folltowlng a 
command that started up ATPK wlth the 


SYo-44 COMPANY CONFIDENTIAL 


DIGITAL 


1 
Comments 


Any line startin 


RSTS/E UPDATE 
System Generation Procedures 


fDET switch. If the keyboard specifl- 
cation {fs missing altogether, a new 
job will. be started at the 
pscudo-keybeard under ATPK's centre). 
The current job at the pseudo 
keyboard, 1£ any, will flrst be killed 
tm this case. If Lost falls to 
attach oa leq in at tne pseudo-key- 
board under ATPK, an error message 
will be printed and ATPK whl) abort. 
If LOGIN falls at any other keyboard, 
no error will be returned to ATPK. 


g with an exclamation point will be 


recorded In the log and not sent to the contrelled job. 


Control Characters 


Any character pre 


ceded by an uparrow will be converted 


to a control character before being sent to the controlled 


job, If a command lin 


e consists only of an uparrow followed 


by a single character, the single control character will be 


sent to the controlled 


Quoted Characters 


Job with no extra line terminator. 


Any “S" or "I" that is meant to be the first character 


of a line to be sent 


to the controlled jeb, or any *7" of 


*_" in the command file that Is not to be [Interpreted as a 
special character by ATPK must be preceded with the 


underscore character. 


Every underscere character {except 


those preceded by another underscore character) will be 
removed from the command lf{ne before it Is sent te the 


controlled job. 


Using ATPK for System 


sf 


Startup 


If it Is destred, most of system startup may be 


contrelled under ATPK. 
be precessed by the 
following: 


For example, the Eile START.CTL to 
INIT utility could centain enly the 
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DETACH 

LOGIN KB6: {1,2] 

FORCE K80: RUN SATPK 

FORCE KB@: SSTART. LOG=SSTART.CMD/DET/LOG 
END 


When designing the ATPK startup command file, most of 
the functions of INIT will have to be performed with UTILTY. 
The recommended procedure for bringing a non-system disk 
on-line after a crash [fs to clean the disk with ONLCLN.SAV 
and then MOUNT and UNLOCK the disk with UTILTY. 


When starting vp the spooling package under ATPK, two 
points {n particular should be noted. First, the SLOGIN 
command should be used to rce-leg In the pseudo-keyboard 
aftec 8 spooling program detaches. Secondly, when the 
spooling pregrams are Invoked, they generally prompt for 
Input and then sleep while awaiting a response. Since ATPK 
wlll not respond unless the contrelled pregram enters an 
input stall (as epposed to a sleep), ATPK will not detect 
when the spocler needs the command line. This problem may 
be circumvented by iInciuding the startup command(s) on the 
Same command flle line as the command that Invokes the 
spooling pregram,. tf the cemmands are separated with an 
uparrow-M, ATPK will Insert a carriage return (the 
equivalent of a CTRL/M) between the two commands, causing 
them te be sent to the pseude-keyboard at the same time, -but 
as two lines. As an example, the Following sequence In the 
ATPK cemmand £Fille (START.CMD in the above example) will 
start up OPSER, QUEMAN, one line printer spooler and one 
batch processcr. 


RUN SOPSER “MLOG OPSER.LOG;ALL “MCHA FB8: “MDETACH 
SLOGIN : 

RUN SQUEMAN “MDETACH 

SLOGIN 

RUN SSPOOL “MLP8: 

SLOGIN 

RUN SBATCH “MBAB: /NOQUEVE/NODELETE/ ERROR: PATAL 
SLOGIN 


S¥3-42 COMPANY CONFIDENTIAL 


S1giTaAL RSTS/E YPRDATE 
System Generation Precedures 


When using ATPK to start up pregrams such as VTSOPY, 
care must be taken to aveld sequencing problems. If VISaPY 
fs Invoked and directed te detach and display information en 
another terminal, immediate attempts te force cemmands to 
that terminal that would select the desired VTSCPY features 
te be displayed may be forced to the terminal before VTSaPY¥ 
has a chance te open the terminal. In this. case, the forced 
characters may tnveke LOGIN at that terminal resulting in a 
failure by VTS@PY to gain access to the terminal. This 
problem may be avolded by having ATPK execute scme cther 
command{s) (such as an immedlate mede SLEEP statement, if 
running under the BASIC-PLUS Run-Time System} after starting 
the display pregram and befere forcing to the display 
program's terminal. 


Other Features 


By specifylng a leg Elle and KB: as your Input flle, 
you can make 8 copy of interactive dialogue to queue to the 
Sine printer, ete. Nete that ATPY wlll act be completety 
transparent in such a session. The echo of everything you 
type is typed back at you again after you end each line, and 
nothing you type will be sent to the PK until the next time 
your controlled jeb enters a KS input wait. 


When Inputting from the terminal, CTRL/Z'S get passed 
on through to the controlled jeb. A CTRL/C at any time will 
cause the controlled job to be killed, the leg Eile closed. 
and ATPK to exit. A CTRL/C may be sent te the jeb by typing 
uparrow-C. . 


Installing ATPK As a CCL Command 


The following sequence will {install the CCL cemmands 


- "ATPK" and "@7 to cun the ATPK program, Either or beth of 


the commands may be Installed. 
RUN SUTILTY 

FCCL AT-PK=(1, 2JATPK.*;PRIV 30908 
ICCL @-2[1,2JATPK.*;PRIV 39900 
72 


(This assumes that ATPK and UTILTY are beth Ieccated cn 
SY¥:{1,2).) : 
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CSPCOM (CUSP. Compiler) Program 
The CUSP COMPILER 


A new feature of RSTS/E V7.8, CSPCOM (the CusP 
Compiler) generates object modules from the BASIC-PLUS 
utiif{ty programs that can be linked against the RSX Run-Time 
System, eliminating the need for the BASIC-PLUS Run-Time 
System on those systems which would not otherwise use 
BASIC-PLUS or BASIC-PLUS-2. ‘ 


Note 


CsPCcOoM will be included In the RASTS/E kit 
as a maintenance tool only. The use of 
cspcom {fs not supported for any use other 
than the compilation of Digital-supplled 
utility programs that are included with 
the RSTS/E distribution kit. ‘ 


The use of CSPCOM Is not supported fot 
the compilation of the utility programs 
supplied with any optional RSTS/E 
software product unless the installation 
guide for that product specifically 
states that the software {is compatible 
with CSPCOM. 
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Autopatching Package 
AUTOPATCH 


The autopatching mechanism for the CuUSPs has been 
enhanced to allow: 


o Autopatching ef the CUSPs when the library is bullt 
(via BUILD), rather than the old sequence cof 
OLD~COMPILE-PATCH-COMPILE, 

o Checksum verification of source-level patches, and 


o Comments in all phases, except within the text of a 
patch. moos 
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EXAMPLE SYSTEM GENERATION ‘ 
2741 surpert ° owns 
. Ruits-teragnel teeviee * ove 
mae ete * fene contest fF ore 
ee gee . One-line stelue rerert 7 ore 
Doarnnane of RITEZE aveten seneretson, avsnstive enge 
RSOISRGOA's T tone 
If ere’ bre tecsltor cite ness guvart ers — 
insaterscn ee reAe MeN EN Ler Overlereed seek P eve w 
fere wwe. mote F 2008 
Bane eveteo 7 ove é RKOSZAROT* SO F. enor , 
Pratribulion eedive ? orre av RPOZ/APOI"s T soon 
Outeyt aediua * oare RHOZ/MHOI‘® F . e008 
Betete files F enos RPOS/APOS/AT OS‘ F eoze 
tr for arsotM fT ets wo Overlerred seek ? sve 
Benersle soniter * ve TAL TuLesTesesTuss’s F ocee 2 
Beniter nsee eneicé ove TULOsTEIOs/T9OI’ se F soe 
Ronster catching f are wo 7 ; Teoa'e T e008 
Gengrete DASIC-PLUD F tr 6 DECI eres F acoe 
BATIC-PLUE ATE neee opasice pvenad Tusera 7 e008 
PASIC-PLUS eeichinge Ff ores “0 Printers & 2018 
RON oe default ATS enne RXOLZRNOI‘'s PF e008 
‘. CRITICAL cord reader F anne 
TAPSraECEN, Sa CNIEH- GEL Bete Tienes CD31 cord revder 7 anoe 
Sees P.T. cosder & once 
RLV ALCSE OL OTADLIID SF 2030 ete Schen> sine 
DLCs DLIID‘S 7 sone pncaacecY aais 
aad 008 DECret network auecert 7 eve Ll 
ee mele Kacsive t- e008 
erasr ay segs Entended bufferins for LF T ere a 
Outca f sore 2700 surrert ? suoe 
DHIE wit 60 Fines enebied 7 ae Lorse files * 3 ore 
Bateeet cursert for OIE’ F ave Hesteve sobe * e108 
arate ° none 
Femnty bevboards 7 e040 . 
Figure SY¥S-2. System Generation (Page 1 of 7) Figure SYS-2. System Generation (Page 2 cf 7) 


eys-27- COPPAN N 
S¥S-86 COMPANY CONFIDENTIAL Sy¥S-47 OA PARY CONFIDENTIAL 


DIGITAL 


RSTS/E UPDATE 


System Generation Precedures 


Beall buffere f o1700 
fivaten wide lesicote F 6106 
Monitor statistics ? enpe ves 
FIP Kufferine f ove 
Cutended date Bulferine 7 ewoe YES. 
Bick driver ehose f ove 
Recident Bibrerios ¢ ova 

ASN sirectives 7 ore 
Resident dish hendilne 7 ove 
Revident send/recoive * enne 
Resident aterte S78 colle f “woe 


ident file detetesrensee T = tHte 
Res, lesin/allsch/sitripute T = ence 


fesident estaled/lookus 7 anat 


The fellovina svestions deel with the 
PASIC-PLUS run-tine eveten 


ver evs 
Meth erectsion f *eoze 
Lea functions 7 ay é 
Tete functions Ff ar @ 
Print wetns F ors 
Metrices 7 enge vee 
Meine eclihestic onne 


the sveten senerotion dielow ta fintish- 
ed. If wou heve env aceciel reeviresents 
which eseuite editing the atnereted file 
COmMF 10. na oe confasuraiion fale) er 
SYSOCN.CTLtbatch control file) vou sev 
do 10 new. Vhen roads ture "R BYSBAT®. 


Rendv 


aun esvspat 


STSCEM belch erecessiog hee storted. 
If ae eroblees dev during the betch 
erocess tt @ev be sborted dv treing 
*Contral/C%s To restert twee "R BYSBAT". 


Figure SYS-2. System Generation (Page 3 of 7) 


SY¥S-48 


COMPANY CONF [DENT IAL 


ASTE/E UPDATE 


Systen Generation Precedures 


“ec 

HELLO 272 

Pescvordt 

Jobs 3.45 47 8 are deleched under inte sceomt 
Job tuber te attech tof , 

7 other users are lossed tn under this account 


Reade . 


RUM SUTELTY. Bay 
aegurtcH Atit 
ere 


oO1IE 26 


sasetom mys IN 


aR PIP. SAU 

OTPL.O8 se TTOUNT OB JSe TTDYR OR I/DE IMOVARN 
OTD LOTS TTOINT.L9Te FTDUA.LOT/ LE PHOUARN 
ORETS. PAV e TER. GAVE PIN GAVE SNOUARN 

GENT FAV EF IP. SAVeRSY CAV) OVE GAY / TIE SNOWARN 
ORSTS HAPS TER MAP DSK. MAP/DE INQWARN 

SENT MAP SEEP Mat RSH. MAF COVE, MAP DE PNOUARR 
ORSTS STBOTEN. BIB OSH. PETHOVARN 

OLMT STAT IP. STR RSM. STR eOVR. SIRES MOWARM 
ONSP SAVE NMDVE, SAMs RIT7O0. SAUSEE INOUARN 
ONSP .MAP e XBOUN NAP 1K I2790 MAF /DE SHOUARN 
SSP STREANDUR, STD eRIZ7GO CT R/DE THOUARH 
ec 


aR MACRO. GAY 


OTTDURST (DURZCa TN ICOMMON eRERNEL + BX ICOMF 300 INICHELK eRPDEF oT TDVR 


EKRORS DETECTEDE 6 
arc 


aR HATROBAV 


OTIDIWTs TIDRNT /CoTMI COMMON cRERMEL oP ICONF 1G, INICHECK oRBDEF o TIDINT 


EMKORS DETECTED! 0 
e-c 
‘. 


oR BACROLSAY 


07 PL s FEL /Ce ENS COMMON RERNEL » DK E COME £06 INICHECK s TOL 


EKROWS WETECTEDE 6 
ec 


aM LINK, BAY 


CASTE/Z RETSZAZURSTSOTPL p SEAR MTR/X/BIO/E 1012500707 010007 1/7C 


erepantee 

erneRsTe 

Extend section? HORBUF 
Round section? MORBUF 

aren? STPLAG 


Library search? 
ct 


Figure SYS-2. System Generation (Page 4 of 7) 


SYS-49 


COMPANY CONFIDENTIAL 


DIGITAL RSTS/E UPCATE 


System Generation Procedures 


of Ulm say . 
SAe ToD sR Ve DGNe FGLOERSOMIRGTS.VIB/K/BIOLI TOON UL eLO0es 1 /E 
Osnrnety 

fend sectien® DSAFAT 

CLeprere search? SOSEEK 

Lepeary seeren® 

ec 


of Lime. Sau 

OTERST o TERLAs¥e TEROT METER OR EASTS. SIGs Ns BL O12 POOOsUIELOCOsI/O 
eTibuarc 

epmrasis 

Round weclien® TERPAT 

4 ere search? TISvST 

Ladrary search? 

we 


oR Liter Say - 
CRMEVR/T o KHOUR/A/Ue NMDURG TID KMP o DK IERSTS. STB/N/BE 019 7000/01 81000710 
OUncasts 

Round sectsenT IMDPAT 

Labrare search? xeDUR 

Qabeare search? 


eve . 

o® UleK. 940 

SENT LCM sAsieeENTe LHIEANT e DKIRGTS,. S197 701012 760010100071 78 
eineats 

Reund section? ENTEAT me 


oR LIK gay : 
BELO LT oF LE SA SIF IPO LULE IPL AD DRERSTE. OT8/x/9 1001 7000/5 810007176 
OINSASIO 

wound section? FIPRAT 

Libesrs search? BP 

Libeeece search? 

ec 


oR UCHR Say 

OPS ASH/A/UASHOENINE DK LENT, STB/K/P1OLI 7O00/UT BL 0C0LE 
STwansts 

Round eection? ASTPAT 

ave 


af UWE Say 

SOVR ST OVR/A SMe DVR OT NIDURLRG + DK EF IP BT R/N/B1O1000/6 
arwrests 

ec 


of SILUS. Sav 
SSVOLLEs 1 ISVS. BIL oTTIARGTS TERM e DIK SMO LMT /N oF IP /H/T 


arsusnre | 

err EyRsn7e 

eQves ere 

SIMI00T DEFALT 

Dreectory of SIL BUS = BIL on 08-Mar-79 ot 14147 
Mace = Ident Leed Otre frenefer Totel 
ass OF.00@ G09000 672000 ca00e! 15% 

Ten 97.003 220000 17000 900001 = 3 PK 
oan 07.003 170000 905000 oco00! 208 


Figure SYS-2. System Generation (Page §$ of 7) 


SY¥S-SA4 COMPANY CONFIDENTIAL 


RETL/E SRORTE 
System Generstien Prececures 


acer BTS9% 653290 CFUL04 see 
oe foveGG G51G20 GOLOGS vo 
age BT0000 HG75tO ODOT08 Jue 
| hand GIeGvd FPOVOO 901TH LEVEL) Jos 
ove @7.G05 905000 O0406) 006001 ayn 
opt 8.003 846900 612520 FATTI2 448 


bEFaT @?.003 901000 2000 900008 aan 


U eonster ease ta 30% furth 160 seall buffers! 
$1 buffers can be edded te ths atee 796 tot 
16 seakl puffere cor be added without 2 size chense ¢ 


cored 


ec 


ak PIP.BAY 

RPASIC. Save SASIC. ST9/DEINOUARN 
ec . 

oR LERK, BAY 

ORASIC ZZ eEUSPAR/A/Ue BABIC<INIRISSDREGERR.BID/H/HLON777 74/018 4900/C 
SINIMale se 

OINENL IESE 

IMP ATIF SE 

emnetose 

eENEFUse 

mine 

eyersase 

OEMIVE 

Round soclionT PA 

eve 


o& SILUS. BAY + 
OSUSBAS ATS oTTIRASIC 
Directory of BIL EVSPAS.ATE on O8-Mor-7% at L4ta? 


Nee 8 8=ident Load Bize Trensfer total 


OASIC 07.003 104000 675778 oo0dcT 15K 


oc 
beassion tw 


oh PIPLSAY : 
OS1O:COr b78.0/MODEN 2G. *BUSRAS RTS 
SSUBRAS KIDS DE 

we 


’ 
oR Lovoul 

bonfire: 7 

beved oh dlvh Thbeel 13232 blecks in use 

vob Uf User fel t Jd off MBA ot O8-Mee-?P Para? ae 
Fo olher users still loveed on under thie ecceunt 

Sveten KSIS V?.0-046 Hoses FT (1?Feb? 

Wee Chee wav 5 mirwhess 5P.8 teoconds ~ 

Clorsed t wet 10 astules 

Gued afteriuue 


Pigure SYS-2. System Generation (Page 6 of 7) 


SY¥S-5) COMPANY CONFIDENTIAL 


DIGITAL ASTS/E UPDATE 
System Generation Procedures 


Beich Jov everieteds 


Reeds 


Yigure SYS-2. System Generation (Page 7 cf 7) 


SY¥S-S2 COMPANY CONFIDENTIAL 


RSTS/E V7.8 SWS UPDATE 
DIR 


File Specifitation and Directory Structure Changes 


Lek aS. Bosc eE VILAT 
File Teeeyticatiesn a 


Cirectery Structure (range 


File Specificaticn and Directery Structure Changes 


CONTENTS 


Introductlon.. cesses cece weer cece enc enececseccceses DIR=1 
File Specification Changes.......cccscccconcsccee DIR-3 
Device DeSignatorS......ccccesccrsccesercesess DIR-J 
Protection CodeS.cccesecccccccesccreccevecesee DIR-4 
File Specification Switches.......ceeceesecee6 DIR-4 


Directory Structure ChangeS...cccccsecsccsecceces DIA-6 
MED ChangeS..ccccsccecccccccccccccccsccccssres DIR-G6 
UFD Changes .ccccecccscevcnsccssccecceseceserce DIR-B 


CIM PANY CINFIDENTIAL 


RETE/E SRUATE 
Fiie Eperrfacatien ace 


Directery Steucture Manges 


COURSE MAP 


MON 


uuP 


User 
Utility 
Progrems 


BKP * 


Beckup 
Programs 


Dike 


Softwors 
and 
ASTS/E V7.0 


Syrtem 
Generstion 
Procedures 


Overview 
of 
RSTS/E V7.0 


CAC 


Date 
Caching 
Internals 


muP 


Management 
Utility 
Programs 


DIR 


sys 


OvR 


TOMFRSY TOSPFIDENTIAL 


SylsTAs - RT TS/E GRLETE 
File Specsfacatien ant 
Cirectcry Structure Changes 


File Specification and Directory Structure Changes 


“INTRODUCTION 


The RSTS/E operating system supports a variety of 
high level languages: BASIC-PLUS, BASIC-PLUS-2, COBOL, 
DIBOL, RPGII, etc. Regardless of the language in which 
you code, the File specification is the way of telling 
the RSTS/E moniter exactly what actions you want taken 
when a File or device is opened. It is through the file 
specification that you can implement many of the new 
features of RSTS/E V7.8. 


Furthermore, some of these new enhancements have 
required changes to or modifications of the current disk 
directory structure. 


In this module, you will learn not only how to 
specify these new features using the RSTS/E file 
specification, but also the changes to the disk 


Givectory structure needed by RSTS/E to maintain your 
files, 
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FILE SPECIFICATION CHANGES 


Device Designators 


Table DIR-1. Device Designators 


Device 
Designation 
eae eee 


DL 


Valid 
Unit Numbers 


The underscore character can Precede the 
designator. For example: 


“_DL2:£ile.ext" 


device 


e Suppress logical device translation during {lle 
name string scan. 


iad 
. 
we 
' 
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Protection Codes 


Protection code - 128 

* Settable by privileged users only. 

@ Write null characters over 8 compiled file or 
data file when implicitly or explicitly deleted 
by: 

- KItb a file 


~ OPEN FOR OUTPUT 
-  ZEROing an account 


Nete 


On a large file this can be a 
time-consuming process, 


File Specification Switches 


1, /FILESIZE:n or /SIZEin : 


-@ The only way to pre-extend RSTS/E V7.6 large 
files without explicitly writing actual or 
dummy records, For example: 


"PILE.EXT/FILESIZE: 209000" 
Allocate 200,808 blocks for the file 
2. /POSITION:n 


© Place the first block of the Elle at or near 
device cluster non the disk. For example: 


“FILE, EXT/POSITION: 25900" 


Place the beginning of the file at oc near 
device cluster 25009 
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Note 


An executable file has run-time system 
name at offsets 12 and 14 on large file 
systems, 
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Figure DIR-9. UFD Attributes Entry #1 (V6e change) 


Word 2 Record Size (Actual size for fixed “Length 
records or maximum size for variable length 
records) 


Word 3 Highest virtual block number (MSB) 

Word 4 Highest ¥irtual block number (LSB} 
(corresponds to the file seize accounting 
entry) 


Word § °* EOF block number (MSB) 


Word 6 EOF block ‘number (LSB) (block that is the 


logical end of file) 


Word T Offset to first usable byte in EOF block. 
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INTRODUCTION 


The RSTS/E Operating System supports a variety of 
languages. With this release of RSTS/E, each of the 
supported languages is affected in different ways. New 
features are implemented, enhancements are included to 
improve performance, or additional support is supplied. 


This module covers the tollowing software as 
supported on RSTS/E V7.0. 
' 


° BASIC-PLUS 

9 RMS-11 V1.8 

° BASIC PLUS~-2 V1.60 
° COBOL V4 

° MACRO-i1 
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General- 


Virtual Arrays 


o 1/0 buffers larger than $12 bytes 


Commands 
‘COMPILE 
o Defaults to conditionally contiguous .BAC files 
ASSIGN/REASSIGN 
© ASSIGN DEV:/MODE:1 Seizes the device (privileged) 


o ASSIGN DEV:[ppn]LIB Associates the logical name 
LIB with a device and account number 


Note 


Making a user logical PPN assignment 
reduces the mumber of user logical 
assignments to three. 


EXIT 


o Returns to private default run-time system 


oe 


DUMP 


° Dumps user space 
o Available as an optional patch 
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Statements 


CHAIN 
CLOSE -N* 
: o Keyword LINE can be optionally included 
Device dependent close operations not performed : -o Example 
Pending 1/0 butters not written 
Close a tentative Eile without making {ft permanent 
Example 


oaq9 


: 19090 CHAIN “CCpos” [LINE] 90¢ 
3008 ON ERROR GOTO 19088 32767 END p 


10198 OPEN "VIRT.DAT" AS FILE 1%, RECORDSIZE 1824% & 


\DIM #18, P.ARTS$ (3%) 2564 6 Ready: 
\PRINT °I/O0 BUFFERSIZE =";BUPSI2 (1%) & 
\PRINT 
- 1628 FOR I8 = 604 TO 2% & Figure SOP-2. CHAIN 
\P.ARTS$(I8) = STRINGS (2569,18465%) & 
NEXT 18 
32766 : 
32767 = =END 
Ready 
RUNNH 
1/O BUFFERSIZE = 1624 
Ready 
DIR VIRT.DAT 
Name .Ext Size Prot Date S¥:{100,7) 
VIRT DAT Bb] < 68> 28-Nov-78 : 
Total of 8 blocks in 1 file in Sy¥:[(198,7] 
Ready 
Figure SOF-1. CLOSE with Negative Channel 
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setteate aot t Turk vt.2 


Punctions 
DEF* 


ccpos 
° Equivalent to DEF 


° Equivalent to POS(N4) ° Example 
o Example : ? 
1200 BoEE=) Fea(xy = x**2 # 34K + 25 


900 P.RINTSTRINGS = “THIS IS THE PIRST LINE OF THE HEADER” 
10@3 PRINT °...USING THE PGS FUNCTION...° & 2000 FUR 1 = 1 TO 4 STEP -5 & 
\PRINT P.RINTSTRINGS ; POS (Ot) t \PRINT I,,FRA(1) & 
APRINT ry \NEXT I 
\PRINT °...USING THE CCPOS FUNCTION...” & 32767. END 
A\PRINT P.AINTSTRINGS [CPOs (Ou) : 
32767 END Ready 
Ready  RUNNE 
1 29 
1.5 31.75 
2 35 
RUNNH 2.3 38.75 
,..USING THE POS FUNCTION... 3 3 3 
THIS 15 THE FIRST LINE OF THE READER 36 
3.5 47.75 
4 53 


«USING THE CCPOS FUNCTION... 
IH1S 1S THE PIRST LINE OF TRE HEADER 36 


Reaay 


Figure SOF-3. CCPOS Figure SOP-4. DEF* 
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SPECE 


o Performs special operations on disk, floppy disk, 
terminals and magnetic tape. 


° Disk 


~ Explicitly locks up to 7 blocks of a fFlle open 
in update mode 


~ Releases explicit and implicit locks on a file 
bDlock(s) 
Por disk devices, the SPEC® function allows you to 
file cece lock a maximum of seven disk block ranges on a 
file that 1s open tor update. A locked range of blocks is 
one that cannot be accessed by another user or from another 
channel, Thus, SPECt extends the use of guarded update, 
which locks the last block or blocks read on a file. 


’ 


SPECt also allows you to release explicit or pepiicte 
jocks, Note that when you close a fille, all expliclt and 
implicit locks are released for that Elle. 


The SPEC% tunction for disk files has the following 
tormats: 


VALUE S@SPECS (FUNCTIONS, BLOCK, CHANNEL’, HANDLER INDEX) | 


where: 


VALUES depends on the particular function code you 


specify In FUNCTION, In most cases, VALUE% 
1s equal to the BLOCK parameter. 


FUNCTION’ {is a function code that specifies the 
desired operation. During normal I/0 
operations, a block, of range of blocks Is 
implicitly locked when you read the file 
with a SASIC-PLUS GET statement. The SPEC 
function allows you to convert implicit 
locks to explicit locks -and to release 
selected locked blocks. The code specified 
in FUNCTIONR determines the use of SPECt. 
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The codes are as tollows: 
FUNCTIONS=@ release all locked blocks 


FUNCTIONt*#1 release the current implicit 
lock 


FUNCTION%=2 convert the current implicit 
lock to an explicit lock 


FUNCTION%=3 release the explicitly locked 
block specified in the BLOCK 
parameter. If BLOCK is @, all 
explicitly locked blocks are 
released, However, implicitly 
locked blocks remain locked, 


FUNCTION¢=4 convert an impiicit lock to an 
explicit lock and release the 
implicit lock 


BLOCK specifies the starting block number for 
‘ releasing an explicit lock, Note that BLOCK 
must be a floating-point number. 


CHANNEL’ {s the I/0 channel on which the operation is 
to be pertormed, 


HANDLER The handler index of the I/O device open on 
INDEX’ CHANNEL*. The Index for disk devices in 6%. 


If you open a file with a Recordslze greater than 512, 
SPEC3 allows you to lock more than one block when you GET a 
range of blocks read into the buffer. For example, If you 
open the £1lle with RECORDSIZE 1924%, each GET operation 
reads {and implicitly locks) two blocks. I£ you explicitly 
lock blocks 2 and 3 as follows: 


GET #1%, RECORD 2% 
VALUE &=S PEC8 (20,8%,1,68) 
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{ee can then read blocks 3 and 4 (GET RECORD 38) snd cause 
mplicit locks on these blocks, Note that if you attempt to 
lock a range of blocks that overlap an already explicitly 
locked range, the Monitor returns the ?DISK BLOCK IS 
INTERLOCKED error. Also, if a range of blocks 1s locked, an 


explicit release of those blocks must refer to the first 
block in the range, 


The following errors sre possible during a SPEC% 
operation: 


Meaning ERROR 
?NO ROOM FOR USER ON DEVICE 4 


There are too many locks pending on this 
device. You can lock a maximum of seven 
ranges of blocks on a file. 


?7CAN'T FIND FILE OR ACCOUNT - 5 
You specified functton code 3 In the 
FUNCTIONG parameter and attempted to: unlock a 

block that was not locked, 

_ ? PROTECTION VIOLATION 16 
You attempted to explicitly lock a block that 


had not been implicitly locked. An attempt : 


to lock a block after a PUT or UNLOCK can 
cause this error. 


7DISK BLOCK IS INTERLOCKED 19 
You attempted to explicitly lock a range of 


blocks that overlaps an already explicitly 
locked range of blocks, 
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° Floppy Disk SPECS 


- Returns density of a mounted tloppy 
. - Causes floppy driver to recompute density 
- Reformats a floppy to density specified (axo2 
only) 


For floppy disk devices, the SPEC’ function allows you 
to obtain the density (single or double) of the current 
floppy disk, to mount a new floppy disk and recompute the 
density, and to reformat an RX02 Floppy disk for a desired 
density, Because the RX02 Eloppy disk drive supports single 
and double density floppy disks, the SPEC% function ts 
especially useful for programmed floppy disk operations. 
For example, SPEC% allows you to mount a series of single 
and double density floppy disks without having to close and 
reopen the device for each mount. That Is, the driver 
computes density once; during the initial open. If you 
Insert a second Floppy that Is incompatible with the 
initially computed density, read or write operations will 
fall. SPEC& permits you to include an instruction In your 
program that causes the driver to recompute the density. 
Also, tor AX82 floppy disk drives, SPECY permits you to 
specify a density reEormat operation. 


The SPEC’ Eunction for floppy disks has the following 
tormat: 


VALUE%=SPEC4 (FUNCTIONS, PARAMETERS, CHANNELS, HANDLER INDEX$) 
‘wheres 


VALUES depends on the particular functlon code you 
specify in FUNCTION, 


FUNCTIONS fs a functlon code that specifles the 


desired operation. The codes are as 
follows: s 
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CHANNELS 
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INDEX 
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FUNCTIONG=0% returns the density of the 
currently mounted floppy disk 
in the form: DENSITYB=VALUESR 
AND 255%. IE DENSITYt#1%, the 
£loppy is single density; if 
DENSITY%*2%, the floppy ts 
double density. 

Note that PARAMETER§ must also 
be 9%. 


FUNCTION§=1¢ causes the floppy disk driver 
to recompute density. If the 
diskette has been changed in 
the drive without closing and 
reopening the I/O channel, 
issue this code prior to any 
I/O cperatton on the Floppy 
disk, This function also 
returns the computed density as 
described ‘in FUNCTIONS=0t. 
Note that PARAMETERS must be 
Ot. 


FUNCTIONS=2% reformats the current Eloppy 
disk to the density specified 
in PARAMETERS. PARAMETERS 
equals 1% for single density 
and 2% for double density. 
Note that this operation ts 
allowed only on RxX@2 derives and 
that any data on the disk prior 
to the operation is lost. 


see the description of FUNCTIONS. 


1s the 1/0 channel on which the operation is 
to he pertormed. 


the handler index on the 1/0 channel open on 
CHANNELS. The Index for floppy disks is 184%. 
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SPECK can require as much as 20 seconds to retornat the 
density on an AX32 floppy. disk and cannot be interrupted 
with CTRL/C. Note that if the operation is tnterrupted (by 
power .fakluce or catastrophic error}, the floppy disk is 
rendered unusable. That is, the floppy disk will contain 
both single and double density. To recover you must 
cetormat the floppy disk. 


The following errors are possible during a SPECt 
operation: 


Meaning ERROR 
j : 
?DEVICE HUNG OR WRITE LOCKED 14 


A hardware error occured. This can often be 
a transient condition. Retry the operation. 


?MISSING SPECIAL FEATURE 66 


An attempt was made to reformat on an RxXO1 
floppy disk drive. The use of SPECK to 
retormat Floppy disk density is allowed only 
on RxX@2 drives. 


SPEC% can be used In Eloppy disk programming operations 


to ensure that secter opens are correctly handled. That Is, 
the conflict between 128-byte single density buffersizes and 
256-byte double density buffersizes can be resolved by the 
following method: 

To FIELD the buffer; 

FIELD #channel number, 1288 *DENSITY* AS BUFFER RX@2$ 

To PUT the buffer; 

PUT fIchannel number, COUNT 128% *DENSITYS 

When DENSITY*® is; 


DENSI TY%=5PEC8(88,0%,CHANY, 18%) and 255% 
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oe Magnetic tape SPECt 


- Provides equivalent functions as the MAGTAPE 
tunction. 


For magnetic tape, the SPEC’ function allows you to 
rewind the tape, skip records on the tape, and set tape 
density and parity. 


The SPEC% Function for magnetic tape has the following 
formats: 


VALUE §=SPEC¥ (FUNCTIONS, PARAMETER, CHANNEL*, HANDLER INDEX%) 


where 

VALUES depends on the particular function code 
specified In FUNCTIONS. 

FUNCTIONS is the function code. ~ 

PARAMETER depends on the particular function code 
specified in FUNCTIONS. 

CHANNEL? {s the I/O channel on which the operation 
{is to be performed. 

HANDLER | is the handler index on the 1/0 device 
open 

INDEX% ~ on CHANNELt. The index for magtape is 


The SPEC% function performs various operations on 
Magnetic tape as determined by the code you specify in 
FUNCTION. These codes are as follows: 


FUNCTION¢t=1 rewind the tape and take the unlit 
off-line, 


-FUNCTIONG#2 write an end of file marker. 


FUNCTIONS*3 rewind the tape but leave the unit 
on-line. 
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read the tape but skip specified records. 
You specify the nmumbec of records to be 
skipped in PARAMETER. Note that when 
FUNCTIONS is 4, VALUER returns the nunber 
of cecords that were read (i.e., not 
skipped). 


backspace the tape over a specified number 
of records. You specify the number of 
records to be backspaced in PARAMETER, 
Nete that when FUNCTION§ is 5, VALUER 
returns the number of records remaining 
(i:e., not backspaced). 


set the tape's density and parley as 
specified in PARAMETER. The format Cor 
PARAMETER specification, when FUNCTIONS Is 
6, is E+D*44+p+s. The specifications 
E,0,P, and S have the following values: 


E is phase encoded : 
256 = phase encoded mode, refer to value 
of D 
@ = refer to values of D and P 


D is density 
1f£ E=¢ 


@ = 200 bpl (7-track only) 
1 = §56 bpi (7-track only) 
2 = 809 bpi (7-track only) 
3 = 800 bpk (dump mode) 


if £=256 

8 = 16096 BPI 

1 = Reserved for future use 
2 = Reserved for future use 
3 = Reserved for future use 
P is parity 


@ = odd parity 
1 = even parity 
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S is stay if bit 31 
@= the OPEN MODE value is 6 = 1680 bpi 


released on CLOSE 1 = reserved 
8192 = the OPEN MODE value is Z 2 = reserved 
retained on CLOSE : z= reserved 
15 1 last command caused an error 
FUNCTIONt=7 returns the tape status in VALUER. The 


status returned Is encoded as follows: FUNCTIONt#19 returns the Eile characteristics in 


VALUE%. ‘The characteristics returned in 


Decimal : VALUER are encoded as follows: 
Bit Value Meaning 
; : Word=8 DOS format tape 
6-2 t] last issued command was off-line Word<>@ ANSE format tape. If the word 
1 last issued command was read ¥ ls non-zero, the bytes have the 
2 last issued command was write following meaning: 
3 last issued command was write EOF 
4 jast issued command was rewind : 
5 last issued command was skip record Decimal 
6 last issued command was backspace Bit Value Meaning 
record i ; : 
3 6 See bits 13-14 @-11 - For Eixed-length ANSI format, the value 
1 See bits 13-14 E is the record length in bytes. For 
4 8 unit fs TU18/TE10/TS83 variable-length ANSI format, the value 
i unlt fs capable of 16096 BPI is the maximum record length in bytes. 
5 1 unit Is off-line 12-13 6 embedded carriage control 
6 1 the last issued command was a read on 4096 FORTRAN carriage control : 
a record that was larger than the 1/0 8192 implied line feed/carciage return before 
buffer (part of the record is lost)’ the record 
7 : 1 Jast command detected an EOF 14-15 16384 fixed-length format 
8 1 tape ts at tts load point 32768 variable-length format 
9 1 tape {is beyond the EOT marker 
10 1 tape is write-locked FUNCTIONS211 rewind the tape on CLOSE 
11 8 tape has odd parlty . 
i tape has evin parity Note that the operation and values described for 
12 8 9-track tape FUNCTIONS are covered in detail in the RSTS/E Programming 
1 7-track tape : Manual. 
13-14 1£ bit 329 peace 
@ = 209 bpi 
1 = 556 bpl 
2 = 806 bpl : 
3 = 800 bpi, dump mode 
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o Terminal SPECt 


For terminals, the SPEC% function allows you to cancel 
CTRL/O and set modes for tape, echo, and ODT. 


The SPEC% function for terminals has the following 
formats: 


VALUE ¥*S PEC (FUNCT ION®, PARAMETER, CHANNEL*, HANDLER INDEX8) 
where 


VALUER depends on the particular function code 
specified In FUNCTION. 


FUNCTIONR is the function code, The SPEC% functions 
pertorms various operations on terminals as 
determined by the FUNCTION® code, These 
codes are as follows: 

FUNCTION$=@ Cancel CTRL/O 

FUNCTION&=1 set tape mode 

FUNCTIONt#2 enable echo and clear tape mode 
FUNCTIONt=3 disable echo 

FUNCTIONE=4 set ODT mode ; 

FUNCTION&=7 cancel all type shead 


PARAMETER specifies the terminal on which the 
operation is to take place. If PARAMETER 
is 6, the operation is performed on the 
currently open terminal. If you specify a 
keyboard number In PARAMETER, the operation 
{is performed on that terminal. Note that 
the keyboard must be assigned to the 
calling job and must not be open. 


CHANNELS specifies the I/O channel for the terminal 
in PARAMETER. 

HANDLER the handler Index of the 1/0 device open on 

INDEX* CHANNELt. The Index for terminals Is 2%. 
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netion Calls 
String Scan SYS Call 
Suppresses logical device 


Example 


ASSICK MT:KB 


translation 


Ready 
LISTKH 
1000 INPUT "FILE NAME"; FS & 
AVG @ STS(CHRS(6S oCHRE{~108)e" “2F9) & 
- NDEVICES « MID(¥$, 232,25) & 
NPRINT "DEVICE WITHOUT LOGICAL TRAWSLATION I$ "; DEVICES 
ito V9 © SYSCCHAS(GS oCHRS(-VOT)«FS) & 
NDEVICES © MID(YS,232,2%) & 
NPRINT “DEVICE WITH LOGICAL TRANSLATION IS °: DEVICES 
32767 = END 
Ready 
RUNNE 
FILE MAME? KB: 


DEVICE WITHOUT LOCICAL TRANSLATION IS KB 


DEVICE WITH LOGICAL TRANSLATION IS MT 


Ready 


Figure SOF-5. 
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Get Moniter Tables If S¥S Call change System Date/Time SYS call 


o. Returns information on whether or not a system 


is configured for large files o Accepts zeroes for date/time 

o Example o Example 
eee ON eRRnoR COTO 19808 k VS"SYS (CHRS (63) +CHRS (-148) +CHRS (8%) & 
20008 = «=—- RETURNS = STS (CBRS (68) SCARS (-121)) {MONITOR TABLES IT & 

\IP SWAPA(CYTSOIRIGHT (RETURNS 29099) 6 +CHRS (SWAPY (98) )+CHRS (0%) . 

THEN PRINT “LARGE PILE SYSTEM® t +CHRS (SWAPR (O%))) 

ELSE PRIMT “LARGE FILES NOT AVAILABLE® t 
2050 6640 aie WHETHER THIS 18 A LARGE PILE SYSTEM RSTS/E V6C - 71Llegal mode mixing 
19¢es PRINT ERR 6 

3 \RESUME 32767 RSTS/E V7.0 - No error returned 
ie as No change to date/time made 
Ready 
‘sown Directory Lookup Sys Call 
LARGE FILE S¥STEM 
ue o Always returns the correct file size (large file 
4 sys s onl 
Figure SOF-6. Get Monitor Tables yet ree en 
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ASSIGN/REASSIGN Sys call 
2 Byte(s) Meaning 
o Assigns/reassigns user logical names, user logical ; 
PPNs and user detauit protection codes = 13-16 Hot used 
o Selzes a device : 17-16 For assign/reassign device, 
CVT4&S (SWAPt (-32767%)) to assign a device that 
Data Passed: is currently assigned to another user. This 
usage {s privileged and the target device must 
Byte(s) Meaning not be open. 1f this operation is not 
desired, bytes 17 and 18 are 6. 
1 CHRS (6%), the SYS call to FIP . 
For user logical assignment, not used. 
2 CHRS(10%), the asslgn/reassign and enter user ‘ 
logical code. 19-298 Not used : 
3-4 Not used 21 For user logical assignment,CHRS$(255%) to 
. enable protection code assignment {see SYTE 
5-6 For user legical assignment, the : ; 22). 


project~programmer number to be assigned. 
For assign/reassign device, must be 8. 


7-10 For assign device, bytes 7 through 18 must be 
8. 22 For user logical assignment, the protection 
code to be assigned. Byte 21 must be 255. 
For reassign device, byte 7 is the job number For assign/reassign device, must be @. 
to which the device is reassigned. Bytes a . ; 
through 18 must be 8. 23-244 Device name for assign/reassign and for user , 


: logical assignment. 


For user logical assignment, bytes 7 through 


19 contain the legical device name (in ‘ 25+ Unit number for assign/reassign and for user 
Aadix-50 format) to be assigned. logical assignment. 

11-12+ For assign/reassign device, either DOS or ANS , 26+ Unit number flag for assign/reassign and for 
(in Radix-5@ f£ormat) to specify DOS or ANSI user logical assignment. 


label format for the magnetic tape drive. 
; 27-30 Not used 
For user logical assignment, not used. 
Data Returned: No meaningful data is returned. 
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Possible Errors: 


ERR 
Meaning . Value 
?ACCOUNT OR DEVICE IN USE 3 
The specitied device is currently open or has an 
open file, This error can only occur during an 
assign call. 
?NOT A VALID DEVICE 6 
The device name specified in bytes 23 and 24 1s a 
logical device name for which a physical device 
is currently not assigned. 
?DEVICE NOT AVAILABLE 8 
The device specified in bytes 23 through 26 
exists on the system but the operation falls for 
one of the following reasons: 
1. The device {fs currently reserved by another 
job (see bytes 17 and 18). 
2. Ownership of the device requires privilege 
that the user does not have, 
3. The device or its controller is disabled. 
4. The device is a keyboard line for a pseudo 
keyboard use only. 
?PROTECTION VIOLATION 1a 
A program with temporary privilege assigned a 
device, dropped its privilege, and attempted to 
reassign the device. 
7ILLEGAL NUMBER : §2 
An attempt its made to transfer control to a 
non-existent job. This error can only occur 
during a reassign call. ‘ 
SOF-28 COMPANY CONFIDENTIAL 


Siscussiorr 


The user logical assignment call is used to enter 
leqical device names, logical project-programner nunders, 
and default output protection codes. To assign a user 
logical device name, bytes 7 through 18 must contain the 
logical device mame and bytes 23 through 26 must contain a 
physical device name and unit number. To assign 4 user 
logical project-programmer number, specify the number in 
bytes 5 and 6. To assign a user default protection code, 
specify the code in bytes 21 and 22. 


The assign/reassign call used bytes 17 and 18 to assign 
or reassign a device which is currently~assigned. For the 
call to be successful, it must originate from a privileged 
account, the target device must not be open, and the current 
owner can not be pertorming a directory on that device. 


The assign call reserves a physical device to a job* or 
transfers assignment of a currently owned device to another 
job. The actions are equivalent to the ASSIGN and REASSIGN 
Monitor commands. System logical names are assigned either 
by a S¥S call 21 or by UTILTY program commands. 


Example: 


10 AS = SYS (CHRS$ (6%) +CHAS (108) +STAINGS (268,04) + 
"LP*-+ CHRS (13) 4CHRS (255%)) 
{ASSIGN LP]: TO CURRENT JOB 
208 INPUT “ASSIGN LPl: TO WHICH JOB"? X% 
38 AS=SYS (CHRS (68) +CHRS (163) STRINGS (143, 05)+ 
CHRS (XB) +CHRS (GUD 4STRINGS (144,84) 
“LP"4+CHRS (14) +CHRS (255%) ) 
{ REASSIGN LPl: TO JOB — Xt. 


‘The system manager, through an initialization option, can 
designate that certain devices require piivilege to be 
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. Deassign SYS Call 


° Removes user logical assignments 


Data Passed: 


Byte(s) 


7-16 


11-28 
21 


22 


23-24 


Meaning 
CHRS (6%), the SYS call to FIP 


CHRS(114), the deassiqn device and remove us#r 
logical code 


Not used 


For. user logical removal, the 
Project-programmer number to be removed, 


For device deassignment,. must be a. 


For user logical removal, the logical device 
name (in Radix-5@ format) to be removed, 


For device deassignment, must be @. 


Not used 


For user legical removal, CHR$(255%) to enable 
protection code removal, 


For device deassignmant, must be @. 


For user logical removal, the protection code 
to be removed. Byte 21 must be 255. 


For device deassignment, must be 6, 


For device deassignment, the device name to be 
deassigned. 


For user logical Temoval, must be 6. 
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26 For aevice deassignment, the unit number flaq. 
For user logical removal, must be @. 
- 27-30 Not used. 
Data Returned: No meaningful data is returned 
sible Errors: 
Pos ein 
Meaning value 
‘ 
?NOT A VALID DEVICE 6 


The device or device type specified in bytes 23 
through 26 is not configured on the system. This 
error can occur only on device deassignment 
calls, 


Discussion: 


The user logical removal call {is used to deassign 
logical device names, logical project-programmer numbers, 
ang default output protection codes. To deassign a logical 
device name, specify the name in bytes 7 through 19. To 
deassign a project-programmer number, specify the number in 
bytes 5 and 6. To deassign a user logical protection code, 
specify the code in bytes 21 and 22. Note that if these 
bytes do not contain specific deassignments, the call 
deassigns all user logical device name, PPN, and protection 
code assignments. 


The device deassignment call performs the same action 
as the DEASSIGN system command described in the RSTS/E 


System User's Guide. For example, the following statement 
deassigns line printer unit 1, which is assigned to the 
current job. 


1@ AS = SYS (CHRS (68) +CHAS (LIE) #STRINGS (20%, 00) + 


"LP" +CHRS (1%) +CHRS (2551)) 
IDEASSIGN LP]: 
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Create a Job SYS Call 


o Spawns 4 job as long as there is swap space 
available 


Data Passed: 


Byte{s) Meaning 
1 CHAS (6%), the SYS Call to PIP 
2 CHRS (24%), the job creation code 
3 CHRS{NS), where Nt © 


at Spawn If LOGINS are enabled — 
128% Spawn regardless 


Note 
(N& AND 127%) must be 9 
4 Not used, must be 9 
5-6+ The project-programmer number of the 


program to be run, 


7-104 Program name of the program to be run 
in RADIX-58 format. 


11-12+ Extension of the program to be run in’ 
: RADIX-58 format. 


13-22 E Up to 19 bytes of Information; placed 
into the created job's Core Common area. 


23~-26+ . The device name and unit number of the 
Program to be fun. 


27-28 The parameter word to be passed to the 
program to be run. The parameter word 
has exactly the same format and functions 
as the CCL command parameter word. 


29-38 . Not used 
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sate Returned: 
gyte(s) Meaning 


ag The job number times 2 of the job just 
created, 


possible Errors: 
Meaning ERR Value 
NO ROOM FOR USER ON DEVICE 4 


The new job cannot be created. 
Probable causes are: 


a) Further leqins are disabled 
b) The system's job or swap 
slots are (currently) full 
Discussion: : 
The job creating the new job must be cunning undec control 


of the BASIC-PLUS Run-Time System, The job created can run 
under control of any available run-time system. 
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Exit and Clear Program SYS Call 


o Allows a temporary switch to the specified run-time 
system, 


Data Passed: 


Byte(s) Meaning 
1 “CHAS (9%), the exit and set up NONAME 
code, 
2-3 First 3 characters of the name of the 


run-time system, in RADIX-S@ format, to 
which control is passed. If bytes 2-5 
are not specified, or 1£ they are 6, your 
private default run-time system Is used. 


4-§ Last 3 characters of the name of the run- 


time system, in RADIX+5@ format, to which 
control Is passed. 


6 If unspecified, establishes the named 
run-time system as the job's private 
default run-time system. Otherwise, 
CHRS (N&), where NY Is 


2551 to establish the run-time ’ 
system as the job's private 
2 default run-time system. 


8% to enter the specified run- 
time system without 
establishing it as the job's 
default run-time system, 
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wildcard PPM 


° Rew 


wildcard PPN 


Data Passed: 
Byte(s) 


1 


3-4 


1-22 
23-24+ 


25+ 


Lookup SYS Call 
with V7.8 


Lookup - Not privileged (F=25) 


Meaning 


CHAS (6%), the S¥S call to FIP 


CHRS(25%) ,the code for account number lookup on 
index 


CHRS (NE) +CHRS (SWAPR(NS)), where Nt is the index 
of the desired project-programmer number. If 
Nt is 6, the call returns the project-program—- 
mer number of the Eirst account on the disk 
that matches the wildcard specification. If NS 
is non-zero, the call returns the project-pro- 
grammer number of the N+l account on the 
specified disk that matches the wildcard 
specification. 


The desired project-programmer number. A 
specification of 255 in either Eleld represents 
a whildcard. <A specification of @ for N¥ in 
bytes 3-4 and a non-255 value in bytes 5-6 (no 
wildcard) verifies the existence of the 
specified account on the disk. If both Elelds 
are non-zero and neither fleld is 255, the call 
returns error 5 If the account does not exist. 


Not used 7 

The device name, which must be 2 disk. If 
bytes 23 and 24 are both 6, SY@:{the system 
disk, not the entire public structure) {is used. 


The device unit number 
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264 The unit number flag. I£ byte 26 is 6, SyY@: 
(the system disk) is used. 


Data Returned: 


Byte(s) - Heaning 

3-4 Internal code 

5-6+ pie Project~programmer number located by the 
ca 

7-308 Same as passed 


Pessible Errors: 


ERR 
Meaning Value 
?CAN'T FIND FILE OR ACCOUNT ° 5 


The specified device in bytes 23-24+ ts not a disk 
or no match exists for the specified index value 
in bytes 3-4(see also bytes 5-6). 


?7DISK PACK IS LOCKED OUT 22 


The disk is in the locked state, Execute the call 


undec a privileged account to override this 
condition, 


Discussion: 


This call allows you .to specify a whlidcard account 
number and increment an index value to determine a matching 
Project-programmer number, The wildcard account 


specification is as returned from the filename string scan 
call. 
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neturn Job Status SYS Call 


° New with V7.8 


Seb ST. La SR LATE 


teate art he TL bh wT. 


Return Job Status - Privileged and Not Privileged (F8=26) 


Data 


Date 


Passed: 

Byte(s) Meaning 

1 CHR$ (6%), the SYS call to FIP 

2 CHR$ (26%), the return job status code 

3 CHRS (J¥) - where Jt is the number of the job 
for which status is desired. I£ Jt is Ot, 
information on the caller's job is returned. 
If the caller is not privileged, Jt Is forced 
to 8%. 

4 CHRS(S%), where St is @% or 1%. The value-of 
St determines the information returned on the 
job (see Data Returned). 

5-308 Not used ; 

Returned: 

If St is Ot: 

Byte(s) Meaning 

1 The calling job's job number times two. 

2 Not used 

3 Job number times two of the job for which data 


{s being returned. 


Tf 


the caller is not 


privileged, this byte is equal to byte 1. 
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5-6 


7-8 


$-16 


11-12 


13-14 


15 


16 


17-28 
21-22 
23-26 


27-30 
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Keyboard number of the job's console. If the 
number Is negative, the job ts detached and 
the number {is the complement of the keyboard 
number. 


If the job is attached to a peeuac keyboard, 
byte 5 contains the controlling job's job 
number times two; otherwise byte 5 is 9, 


If the job is swapped out, byte 6 contains the 
job's swap slot location; otherwise byte 6 is 
Q. 

The job's logged in Cpu time Vieset 
significant word) for the current session in 
tenths of a second. 

The job's current connect time fn minutes, 


The job's current KCTs (least significant 
word) for this session. ~< 


The job's accumulated device time for the 
current session In minutes, 


The most significant byte of the job's KCT. 


ihe most significant byte of the job's Cpu 
time. : , 


The job's nama in two Radix-508 words. 
The job's project-programmer number. 


The name of the job's default run-time system 
in two Radix-58 words. 


The name of the job's current run-time system 
in two Radix-58 words, 
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Byte(s) 
1 
2 


3 


15-16 


17 


18 


19 


BTU VTAZ PAL SPURTE 
Gattware anf ELISE 7Le 
Meaning 


The calling job's job number times two. 
Not used 
Job number times two of the job for which data 


is being returned. If the caller {is not 
privileged, this byte is equal to byte lL. 


ny 


Keyboard number of the job's console. 1f the 
number {8 negative, the job is detached and 
the number is the complement of the keyboard 
number. 

The job's current flag word. 

The job's current [OSTS byte. 

The job's current information posting byte. 
The job’s current JBSTAT word. 

The job's current JBWAIT word. 


The size of the job's current user memory area 
in K words. 


The job's current word From its memory control 
sub-block, 


The job's current physical address in 32-word 
increments. 
The job's priority. 


a 


The job's allotted run burst in tenths of a 
second. 


The job's maximum allowable memory size in K 
words, 
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20 The value at offset 6 in the job's work block. possisie Errors: 
This value ts usually the channel number 
{times two) on which the job ts Performing an Meaning 
I/O operation, 


ERR 
Value 


- PPROTECTION VIOLATION . - 18 


21-22 If bytes 9 through 12 indicate that the job ts 
in a keyboard walt state, bytes 2] Pie 22 The calling job Is not logged in. 
contain the value at offset 12 (octal) in the 
job's work block, This value Is the timeout 7ILLEGAL SYS{) USAGE 
Pacameter for Input from the terminal, If the 
value is negative, {t implies that the Thea calling job number is less than zero 
terminal is in a keyboard monitor (CTRL/C) F or greater than JOBMAX. 
input wait state, 


18 


If bytes 9 through 12 indicate that the job is 
in an 1/0 stall for a non-keyboard device, 
bytes 21 and 22 contain the generic name (in 
ASCII) of the device for which the job ts 
stalled. 


If bytes 9 through 12 ind{cate that the job Is 
in a FIP wait state, byte 21 contains the byte. 
value corresponding to the currently executing 
FIP Eunction and byte 22 has no meaning. 


23-24 The value at offset 16 (octal) in the job's 
work block. This value is usually an Internal 
code that specifies whether the job {s readjng 
or weiting on the current I/0 channel. If the 
job 1s In an 1/0 watt state and this value Is 
2, the I/O operation is a read; if this value 
is 4, the 1/0 operation ts a write, 


28-26 A potnter to the beginning of the job's Job 
Data Block. 


27-28 A pointer to the beginning of the job's second 
Job Data Block, 


29-36 If the job is a receiver, these bytes contain 
@ pointer to the job's receiver identification 
block; otherwise, these bytes are 9. 
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Execute CCL SYS Call 
° New with v7.¢ ; 


o Allows execution of CCL commands while a program {ts 


TILLEGAL SWITCH USASE 


witch was specified for the 
: h as requesting a size 
han the System's SWAP MAX. 


An illegal 
CCL command, suc 
that is larger t 


running 
Data Passed: — 
et Heke: Other errors will not be detected psi 
: CHAS (14%), the execute CCL command Call the current program has been removed a 
execution of the invoked progr 


2-128 The string to be executed 


Data Returnt The target atring is equivalent to the passed 
string. 


Discussion: 

This call scans the string that is passed to determine if it 
{s a valid CCL command, If it is, the command is executed 
as though It had been typed directly to a keyboard monitor. 


If the string passed {s not a CCL command, execution of the 
Progtam continues at the next statement, 


Possible errors: ‘ 
. Meaning . ERR Value 
?7LINE TOO LONG 47 
The string that was passed is too 
long to be executed as a CCL 
command, 
?ILLEGAL NUMBER 52 


An illegal number was specified as an 
argument to one of the CCL switches, 
such a specifying "/SIZE:A" 
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ted. 
ie che RSTS/E System Directives Manual.) 
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Data Caching Sys calls 


o 


Data Passed: 


Byte(s) 


1 
2 


5-6 


Enabling and Disabling Disk Caching» 


Meaning 


CHRS (6%), the SYS call to FIP 


CHR$(19%}, the enable and disable cache code 
CHRS (N%), where NE Iss 


8 to enable directory and data caching. In 
addition to this byte, data caching 
requires a value Setting In byte 1, 
Note that bytes 4 through 12 are used 
only 1£ this byte equals g. 


128 to return the current caching parameters, 


A 128 value in this byte does not enable 
or disable data caching. 


1 to disable all caching 


CHRS(C&), where C¥ Is the cache clustersi‘ze. 
If ct fs 6, the current clustersize is used 
(see Discussion). Cache clustersize can be 
specified as 1,2,4, or 8 blocks, If ct Is 
greater than 8, 8 Is used, 


CHRS (L¢)+CHRS (SWAPE(LE)), where Lt sets a 
limit on the ‘total number o£ cache clusters 
that can be used, I£ Lt is @, the current 
limit is used (see Discussion). Tf Lv ts 
Non-zero, it specifies an upper limit on the 
number of clusters in the cache, Note that 
1£ the amount of xBUF avallable to the cache 


is less than L&, the cache will not exceed 
XBUF. 
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CHRS (DX) 4+CHAS (SWAPL(DI)}), where DY sets a 
limit on the total numbee of cache clusters 
allocated for directory caching. If 5% is @, 
the current limit is used (see Discussion). 
If pt is non-zero, it specifies an upper 
limit for the number of clusters in the cache 
that are avaliable for directory caching. 
Note that the number of clusters allocated 
for directory caching during a particular 
operation can be less than Dt. 


CHRS (UR) +CHRS (SWAPS (UL)), where Ut sets a 
limit on the total of cache clusters 
allocated to user data caching. If ut ts 
Non-zero, it spectEies an upper limit for the 
number of clusters in the cache that are 
available for user data caching. Note that 
the number of clusters allocated for data 
caching during a particular operation can be 
less than Ut. 


CHRS(E%), where EY modifies the enabling/dis- 
abling of data caching as follows: 


Ets use the current setting 


Et=1 enable data caching as specified In 
Elle OPEN MODE or directory flag 


£39128 disable all data caching 


Et=64 cache all data transfers regardless 
of Eile OPEN HODE 


CHRS$(M%$), where M& controls the cache's use 
of the small buffer poo] as follows: 


Mt=8 use the current setting 


Mt=) use the small buffer pool 
Mt=126 do not use small buffer pool 
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Data Returned: 


Byte({s) Meaning 
1-2 Internal coding 
3 Current cache setting and available options 
8 Cache disabled, user data caching is not 
available 
1 Cache enabled, user data caching is not 
avaflable 


128 Cache disabled, user data caching ia 
avallable 


129 Cache enabled, user data caching fs 
available 


a-12 Current settings of cache Parameters, as 
Gescribed for passed data. Note that these 
bytes have meaning only if the system manager 
has Installed user data caching during system 
generation, 


Possible Errors: , 


ERA 
Meaning Value 
?ACCOUNT OR DEVICE IN USE 3 
All of the clusters allotted to the cache are 
in use, 
?NO ROOM FOR USER ON DEVICE 4 


An attempt was made to enable data caching 
without suf€ielent XBUF space sllocated.to the 
cache, The system manager must allocate at 
least 2K words of memory to XBUF for caching. 
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2DEVICE NOT AVAILABLE 8 


An attempt was made to change the cache 
clustersize (see Byte.4) while a cached file 
disk transfer was in progress. Retry the 
operation. 


?PROTECTION VIOLATION 18 
The current user is not privileged. 
?MISSING SPECIAL FEATURE 


Caching was not configured for the system 
or data caching was configured and use of the 
small buffer pool was requested. 


Discussion: 


Bytes 1,2, and 3 of this call enable or disable the FIP 
buffering module that controls directory caching. The 
ENABLE CACHE and DISABLE CACHE commands of UTILTY use these 
bytes, 


If user data caching was configured on the system 
aur ing system generation, bytes 1 through 12 enable or 
disable user data caching and set the parameters of the 
cache, The system manager defines the total size of XBUF . 
during system initialization and some portion of this space 
is, in turn, used by the cache. The disk caching S¥S call 
defines the size of the directory portion or the data 
portion of the cache. The sizes defined in this call set 
upper limits, not fixed sizes. Thus, {1£ a 48K word XBUF 
were defined at system Inittalization, the SYS call could 
define the directory and data portions of the cache as 25K 
each, That Is, data can use the space In the cache up to a 
maximum of 25K, which leaves a minimum of 15K for the 
directory. The reverse is also true. In this manner, data 
and directory caching are guaranteed a minimum allocation 
and are allawed to overlap, which permits the cache to 
dynamically adjust to system and program requirements. 
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This SYS call ts also used t 
© limit th 
an a ee Oe. XBUF is used by -. eats 
’ m ng the cache guarantees that 
avallable in xsur for DECnet/E, Note that She aac 


directory data are cached. The cache clustersize should be 


only random caching is allowed. R ’ 
. efer to th S ¥ 
Manager's Guide for cache clustersize guidelines systen 


Note that the parameters for l 
cache clustersize a 
oe eitecation (Bytes 4 through 19) have ae rscit 
cache alustereioe te rece init aa ae sti ae aad 
mits on director d 
der sults enty ee The system Manager can penat’ thece 
an INIT option ag described tn the RSTS/E 


System Manager's Guide, 
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Kew with v7.0 


Sets a file's directory data cache 
characteristics 


Makes a contiguous file non-contiguous 
Changes a Elle’s placed bit setting 
Obtains flle's starting DCN 

Changes a file's run-time system name 
Changes a file's backup characteristics 


Returns an unopened Elle's run-time system name 
and attributes 


File utility Functions - Privileged 


Date Passed: 
Byte(s) 
1 
2 


Meaning 
CuRS (6%), the SYS call to FIP. 


CHRS(~26%), the Eile utility code. 


CHRS (Nt), where N&® {is the internal channel 
number (in the range of 1 to 12) on which the 
file is open, 


If N% {is @, specify the target flle b 
Project-programmer number, f£ilename, an 
extension in bytes 5 through 12. 


CHRS(F%), where Ft specifies the File utility 
function. The function Ft is one (or the sum) 
of the Following codes: 
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1s Set or ceset the file's placed bit (can 
not be used with code 81). See byte 15. 


2% = =modify code 16% to return @ as the device 


cluster number (DCN) 1£ the Eile's placed 
bit Is not set. 


4% change the file's backup statistics. 


8% change the file's run-time system name 
fleld. 


16 return the file's retrieval information. 
That is, 16% causes the Monitor to map 
the virtual block number (VBN) of the 
€lle Into the disk DCN. This code can be 
used to obtain an existing file's DCN In 
erder to place a new file near it (see 
Discussion) 

324 unset the file's contiguous bit. This 
code allows you to extend a contiguous 
flle, however, the file is made 
non-contiguous. 


64% enable/disable sequential mode caching if 
the f£1le Is cached (can not be used with 
code 8%). See byte 15. i 


128% enable/disable data caching on the Eile 
(can not be used with code 89). See byte 
15. 


If Nt In byte 3 is 4g, specify the 
project-programmer number of the file you wish 
to modify. 

If Nt is non-zero, these bytes are ignored. 

IE NY in byte 3 Is 8, specify the filename (in 
Radix-59 format) of the file you wish to 
modify. 


If WR is non-zero, these bytes are {gnored. 
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1f NV in byte 3 ts ©, specify the file 
extension (in Radix-S0 format) of the tlle you 
wish to modify. 


If N& in non-zero, these bytes are ignored. 


The specifications that you make in these 
bytes are dependent on the function code 
specified in byte 4, as follows: 


If byte 4 AND Bt<>8t, then bytes 13 through 16 
contaln the new run-time system name field in 
Radix-5@ format. 


Otherwise; 


If byte 4 AND 16%4>0%, then bytes 13 and 14 
contain the low order word of the VBN you wish 
to locate, byte 15 contains @% orc is used by 
another operation, and byte 16 contains the 
high order word of the VBN you wish to locate. 


If byte 4 AND 14%464%4128%, then bytes 13, 14 
and 16 contain zeros or are used by another 


_ operation, byte 15 contains flags for the 


following operations: 


2% new value for the placed bit if byte 4 
AND 1t¢>9%. 


4% new value for sequential bit I£ byte 4 
AND 64806508. 


128% new value for cached bit {ff byte 4. 


If the change Fille backup statistics function 
{1s selected in byte 4 {code 4), these bytes 
specify a new date of last access for the 
File. If no change of date Is desired, 
specify 9. 


I£ the statistics function Is not selected, 
these bytes are Ignored. 
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If the change file backup statistics function 
is selected in byte 4 (code 4), these bytes 
specs ty a new date of creation for the file. 
If no change of date Is desired, specify 4. 
I€ the statistics function is not selected, 
these bytes are ignored. 


1f the change fille backup statisties function 
is selected In byte 4 (code 4), these bytes 
specify a new time of creation for the flle. 
If no change of time {s desired, specify 9. 
I£ the statistics function is not selected, 
these bytes are ignored. 


If N& in byte 3 is 8, specify the name of the 
device that contains the file you wish to 
modify. The device must be & disk and s 
specification of @ in bytes 23 and 24 
Indicates the public disk structure. 


If N% is non-zero, these bytes aré ignored. 

If N& in byte 3 Is 9, specify the unit number 
and unit number flag associated with the fille 
you wish to modify. 


If NY ts non-zero, these bytes are ignored. - 


“ Not used. 
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tne tile’s chacacteristics 


pyte(s) 


ace returned as follows: 


Meaning 


1 Not used 


2 byte b= 2 


file is placed 


byte 1 = 4 file will be cached 


byte 1 = 16 
byte 1 = 128 


3-4 


5-26 


27-38 


sequentially 1£ at all 
file is contiguous 


file will be cached on open 


If the file*’s VBN was passed In byte 16 and 
flle retrieval information (code 16) was 
requested in byte 4 (see Data Passed), these 
bytes contain the DCN of the file's VBN, Note 
that these bytes return @ if the specified VBN.- 
is larger than the Elle size or if the file 
was not placed and function code 2 was not 
passed in byte 4. 


File attribute data; unused words are filled | 
with zeroes. 


The file's run-time system name in Radix-5é 
format. 


Possible Errors: 


ERR 
Meaning Value 
2CAN'T FIND FILE OR ACCOUNT a 5 
The Elle or account specified in bytes 5 
through 12 is not present on the disk. 
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?1/0 CHANNEL NOT OPEN st 9 


The channel specified In byte 3 is not open. 
7PROTECTION VIOLATION 19 


The Eile open on the channel specified in 
byte 3} 1s not a disk Elle or the job lacks the 


privilege reguired for the specified 
operation. 


7ILLEGAL SYS() USAGE 38 


The file open on the specified channel {s not 
a disk flle or is a user Elle directory. 


Discussion: 


This call supplements the functions of the change file 
run-time system name call (FIP SYS Call -17) and the change 
file statistics call (FIP SYS Call -11}) to support large 
files and to add support for file placement. You can also 
use this call to obtain a file's run-time system name and 
attribute data without opening the file, 


The run-time system name fleld (see Data Passed, bytes 
4 and 27 through 38) in the accounting entry of the file's 
User Fille Directory contains file size information for large 


Elles. The two-word run-time system name field is decoded 
as follows: . 


1. I€ the first word is non-zero, the data in both 
words {s the run-time system name. The file size 
is limited to 65535 blocks. 


2. If the first word is @, the low order byte of the 
second word contains the most significant bits of 
the file size. The Eile size is limited to 2**23-1 
blocks. The high order byte of the second word 1s 
reserved and must be @. 
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the tollowing restrictions apply to large files: 


. Because a runnable file can not have both 4 
; run-time system name and a most significant byte 
indication in the same Eleld, large Elles are not 
runnable. 


2. You can not extend a compiled file beyond block 
65535. An attempt to extend a compiled file past 
block 65535 results in a ?PROTECTION VIOLATION 
error {ERR=19). 


3. You can not rename a file that is larger than 65535 
blocks with the Intent of assigning a compiled 
protection code. The attempt is rejected with no 
error and the compiled bit remains off. 


4, When you extend a file past block 65535, it loses 
its run-time systém name, 


5, You can not change the run-time system name of a 
Elle that is larger than 65535 blocks. The attempt 
results in a ?PROTECTION VIOLATION error. 


6. You can not change the run-time system name of a 
compiled file to two words of zeroes. The attempt 
results in a ?PROTECTION VIOLATION error. Note 
that you can perform thls operation on a 
non-complled File. 


7. You can not change the run-time system name of an 
Elle to a zero word followed by a non-zero word. 


To place a Eile in a particular position of the disk, 
you specify the desired disk DCN (Device Cluster Number) a8 
returned ‘in bytes 3 and 4 of this call in the file 
specification /POSITION switch (see the ASTS/E System User's 
Guide). The Monitor attempts to place the first block of 
the file at or after the specified DCN. If the file 
placement is successful, the placed bit (bit 1, mask value 
2) In the file's urD entry is set (see SYS calls -10 and 
-23). If the Eile placement is not successful, the first 
block of the Efile Is placed at the lowest [ree block on the 
disk, the UFD placed bit Is not set, and no error Is 
returned. 
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nesident Library STS calls 
add a Resident Library - Privileged (FQ--18) 


pata Passed: 


Byte(s) Meaning 

1 CHRS (6%), the SYS call to FIP 

2 CurR$(-16%), the resident library manipulation 
code 

a ae CHR$ (16%), add a resident library 

4 Not used 

5-6+ py project-programmer number of the flie to 
a 


7-10+ The resident library name in Radix-58 format - 


11-12 CHAS (AB) +CHRS (SWAPE(AE)) + where A& is the 
1k-word section of memory at which the 
resident library is to be loaded. The 
numbering begins at the first available 
lX-word section and ends at n-l (where n is 
the total number of 1K-word sections of memory 
on the system). At must be specified and 
cannot be zero. 


13-17 Not used 


18 CHR$(St), where S% is the stay flag. If st is 
128% (the high bit set), the resident library 
fs made pecmanently resident. If 5S% is 6t, 
the memory occupied by _ the library can be 
freed for user space whenever the usage count 
of the library is zero (mo active task is 
accessing the library}. 
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CHRS (FR) +CHRS (SWAPO(F2)), where Ft is the flag 
word that defines the characteristics of the 
library. Only the high byte 1s used for flag 
bits. Ft is the sum of the bits set, as 
follows: 


Ft=2568 Not used 


Fee5128 The resident library is 
avallable to only one user, It 
is not shared by multiple 
users, 


Ft91024¢ The resident lfbrary allows 
read/write access to its 
memory, rather than read only 
access. 


F-20488 The resident library does not 
record errors in its code In 
the system error log. 


F-40968 ’ Tha resident Library is 
immediately removed from memory 
when its usage count equals 


zero. 
FU=81929 Not used ‘ 
Pt=-1636446 Not used 


FO"32767041% Not used 


Protection code for the installed resident 
llbrary. To specify a protection cede, byte 
21 is non-zero and byte 22 contains the 
desired protection code. To accept the 
default protection code, byte 21 is @. The 
detault protection code is <42>, which means 
that the Monitor grants read access to all 
users but dentes write access. 
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23-264 The nsane of the disk device on which the 
resident library ts to be stored. If no name 


ls specified, S¥: is used. 
25+ Unit number , 
26+ Unit number flag 


27-398 Not used 


Data Returned: No meaningful data is returned. 


Possible Errors: 


Meaning 
?NO ROOM FOR USER ON DEVICE 


You specified an address in bytes 11 and 12 
that would cause the Monitor to load the 
library in such a manner that memory would be 
fragmented and a swapping violation would oc- 
cur. Refer to the RSTS/E System Generation 
Manual for guidelines on avoiding memory frag- 
mentation. 


?CAN'T FIND FILE OR ACCOUNT 


You specified a filename in bytes 7 through 10 
that cannot be found {n the account specified 
{in bytes 5 and 6 on the device specified in 
bytes 23 through 26. Ensure that the Filename 
ye" specify has a .LIB extension and is located 
n the specl£ied account and device. 


TPROTECTION VIOLATION 


The file you wish to add is in improper format. 
For example, this error occurs If you specify a 
Eile that is not contiguous or has illegal 
entries in the SIL index. : 


18 
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?NAME OR ACCOUNT NOW EXISTS 16 


You Specified the filename of a resident 
library that already exists. — 


?ILLEGAL BYTE COUNT OF 1/0 31 


You did not specify a load address in bytes 11 
and 12 or the address you specified {ts not 
avallable, Refer to the memory status report 
o£ a display program to determine an available 
tange of memory. 


?NO BUFFER SPACE AVAILABLE 32 


A small buffer is required for the description 
block of an added resident llbrary. This error 
{s returned If a small buffer fs not available. 


Discussion: 


The Monitor SYS call te add a resident library is 
privileged and allows you to add a specified library to the 
Monitor's list of resident libraries. This call {gs similar 
to that used to add a run-time system except that you must 
specify a load address for the library. That is, unlike 
run-time systems, the Monitor does not automatically decide 
where to load a resident library. Also, the library Eile 
does not have to reside in account (8,1); however, the file 
extension must be .LIB. 


For additional information on the creation and use of 
resident libraries, refer to the ASTS/E Task Builder 
Reference Manual, 
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Renove & Resident Library - Privileged (F8=-13) 


Data Pagseds 


Byte(s) : Meaning 

1 CHAS (6%), the SYS call to FIP 

2 CHRS$(-16%), the resident library manipulation 
code 

3 CHRS (20%), remove a resident library 

4-6 Not used 


7-10+ The resident library name in Rad\ix-56 format 


11-38 Not used 


Data Returned: No meaningful data is returned 


Posatble Errors: 


ERR 

Meaning Value 
?ACCOUNT OR DEVICE IN USE 3 
You attempted to remove a library that is being 
loaded into memory or is tn use by the 
currently running job. A resident library can- 
not be removed while a job is still attached to 
it. 
?7CAN'T FIND FILE OR ACCOUNT 5 
You specified a resident library name in bytes 
7 through 18 that 1s not currently defined. 
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Discussion: 


The Monitor SYS call to remove a resident library is — 


privileged and allows you to remove the llbrary £Erom 
physical memory, delete the Monitor structure that defines 
the library, and close the library File. 
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hiterk ote te SELaTE 


Satteare at beatae £ St.2 


a Resident Libracy - Privileged (F3=-13) 


Passed: 


Byte(s) 


1 


13-17 


19-30 


Meaning 
CHRS (6%), the SYS call to FIP 


CHRS$(-18%), the resident library manipulation 
code 


CHRS$(18%), load a resident library 
Not used 
The resident library name In Rad{ix-50 format 


CHRS (AY) +CHRS (SWAPR(AR)), where At is the 
1k-word section of memory at which the library 
is to be loaded. The numbering begins at the 
first available iK-word section and ends at 
n-1 (where na is the total number of ]K-word 
sections of memory on the system}. If At is 
Ot, the Monitor uses the load address that was 
initially set for the library when it was 
added, If A% 1s non-zero, the value specified 
replaces that initially set for the library. 


Not used 


CHRS(S%), whece St is the stay flag. If St ts 
128% {the high bit set), the library is made 
permanently resident ({f.e,, the usage count is 
always non-zero). If S& is 0%, the memory 
occupled by the library ‘is freed for user 
space whenever the usage count is zero. 


Not used 
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Data returned: No meaningful data is returned 


Possible Errors: 


ERR 

Meaning Value 
?NO ROOM POR USER ON DEVICE 4 
You specified an address in bytes 11 and 12 
that would cause the Monitor to load the 
library in a position where memory would be 
fragmented and a swapping violation would 
occur. Refer to the RSTS/E System Generation 
Manual for guidelines on assIqning and allocat- 
Ing memory to avold fragmentaton. 
7CAN'T FIND FILE OR ACCOUNT i 5 
You specified a filename in bytes 7 through 1¢@ 
for a resident library that is not currently 
defined. 
?ILLEGAL BYTE COUNT FOR I/O 31 


The load address was not specified in bytes 11 By 
and 12 of the address specified is not 
available, Refer to the memory status report 

of a display program to determine an avallabie 
range of memory. 


Discussion: . 


The Moniter SYS call to load a resident library is 
privileged and allows you to specify a position in memory 
for the library. That is, you can use this call to move a 
cesident library from {ts current position in memory to a 
position of your cholce. Note that 1£ you wish to move a 
library to a permanent position in memory, you must set the 
stay bit (see format description). The stay bit ensures 
that the library’ will remain in the specified location for 
the duration of the current time-sharing session. 
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unioad a Resident Library - Privileged (FO=-18) 


Data Passed: 


Byte(s) Meaning 
1 CHRS (6%), the SYS call to FIP 
2 CHRS (-18%), the resident library manipulation 
code 
; 3 CHRS (22%), to unload a resident library 
4-6 Not used 


7-104 The resident library name in Radix-50 format 


11-36 Not vesd 


Data Returned: No meaningful data is returned, 


Possible Errors: 1 


EAR 
Meaning value - 
VACCOUNT OR DEVICE IN USE 3 


You attempted to unload a resident Ilbrary that 
is in the process of being loaded or 1s In use by 
the currently running job. <A library cannot be 
unloaded while'a job is still attached to it. 


?CAN'T FIND FILE OR ACCOUNT 5 


You specified a filename in bytes 7 through 190 
for a library that {s not currently defined, 
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Discussion: lenenting New RSTS/E Features under BASIC-PLUS 


tap 
The Monitor SYS call to unload a rcesident library is eating and Accessing Large Files 
privileged and allows you to remove the library from semoty . = : i j 
and free that portion of memory for use by othér jobs, o  Pre-extending a large Elle 


1000 OPEN “file.ext/S1:7000@ “FOR OUTPUT..... 


Note 


The switch on the Elle specification must 


be used since the FILESIZE option of the 
OPEN statement accepts only integers. 


° Reading from and writing to a large file 
GET #N%, BLOCK X 
PUT #N%, BLOCK X 


Note 


The BLOCK modifier accepts floating point 


numbers. RECORD modifier accepts 
integers, 


SOF-62 COMPANY CONFIDENTIAL SOF-63 COMPANY CONFIDENTIAL 


DIGITAL ASTS/O VIL Sas sPtate 
Softwace and ASTS/E v2.8 


Specifying Data Caching 


Note 


Data caching must be configured into the 
monitor. 


Data Caching 


When a user job executes a read request, the monitor 
performs a disk access and transfers the requested data from 
the disk to the user job's buffer. On systems that have 
many jobs requiring large amounts of data, the large number 
of disk data transfers can have an impact on response time. 


Data caching is a method whereby a privileged user can 
reduce data transfers from disk. When caching is enabled, 
the monitor stores the most recently read (accessed) data 
blocks in an area of memory called the cache. If the user 
job then requests a data block that {s present in the cache, 
the monitor copies the requested data directly from the 
cache into the job's buffer. thus, the monitor avolds a& 
physical disk access operation. 


Data caching is most useful for read operations tin that 
it can minimize disk transfers. In a write operation that 
modifies existing data, the data is updated in the cache and 
on disk but no new data Is installed in the cache. 


The system manager configures caching on the system and 
optionally sets its parameters during system initialization. 
A privileged user enables or ‘disables caching and determines 
the size of the cache by means of the disk cache enable S¥S 
call or the UTILTY system program. The SYS call or UTILTY 
are also used to specify caching for a particular file by 
marking the flle’s UFD entry. If a new file {is to be 
created and accesses to it are to be cached, use the MODE 
values In the OPEN statement. However, because the use of 
caching MODE values Is privileged, a privileged user should 
desiqnate a Elle for caching by means of the file's UFD 
entry (1.e., use the Elle utility SYS call or UTILTY). 
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ence a tile's UFD is marked for caching, it will be cached 
on OPES regardless of the user's privilege as long as 
caching is enabled an the system. 


when caching is enabled the cache receives all data 
transfer requests that are directed to the disk driver. 
Because the cache contains data, read operations on data 
that is in the cache occur without placing a load on the 
disk driver. The monitor constantly updates the cache such 
that it contains the most recently requested data. 


During system initialization (or with the disk cache 
enable sys call}, the system manager sets the cache cluster 
size, The cluster size (1, 2, 4, or 8 blocks) determines 
the smallest amount of data transferred into the cache on a 
disk access. For example, when the cache cluster size is 
set at 8 blocks, a read operation that installs data in the 
cache causes the monitor to determine the number of cache 
clusters needed to fulfill the request. If a single cache 
cluster is required, 8 physically contiguous blocks 
(including the requested blocks) are installed. IE more 
than one new cache cluster is required to full fill the 
request, a separate disk access is performed to install the 
data into each of the required cache clusters. However, [f 
the number of new cache clusters required is more than two, 
the data {fs not Installed in the cache but is transferred 
directly into the user buffer with a single disk access. 
Note that the cache cluster size should not usually be 
Mae than the pack cluster size that was set during disk 
nitialization. The Monitor allocates space for the cache 
from the Extended Buffer Pool (XBUF). 


User Data Caching (Random Mode) ~ MODE 256% 


A privileged user can specify MODE 256% In an OPEN 
Statement to cause data transfers from a Elle to be cached 


in random mode, MODE 256% has effect only 1f data caching 
is enabled on the system, 
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The menitor schedules data transfers into the cache on 


the basis of time since last access. That is, new data 
replaces data currently in the cache if the currently cached 
datas 


1. Is the data with the longest time since last 
access, and 


2. has been in the cache for more than the minimum 
residency as established by the system manager. 


1€ a data block meets these requirements, it is 
replaced when the monitor seeks to place a new data block In 
the cache. 


As an example of random cache operation, consider a get 
statement that is executed on a Elle opened with mode 256%. 
When a read on the cached file occurs, the monitor examines 
the contents of the cache to determine if the requested data 
item Is present. I£ the data is in the cache, the data {is 
copled from the cache cluster that contains it. The data Is 
made available to the program and the cache cluster Is 
linked to the beginning of the Ilst of cache clusters. The 
list of cache clusters is maintained in order of increasing 
time since last access, 


If the requested data item is not oresent In the cache, 
the monitor examines the list of cache clusters to determine 
the time of last access for the oldest item in the cache. 
If the time {s less than the minimum residency, the 
teguested data cannot be installed in the cache and a normal 
disk read is pertormed. If the time is greater than the 
minimum residency, the requested data is Installed in that 
cache cluster and made available to the program, 


User Data Caching (Sequential Mode) ~ MODE 20488 


MODE 2048% has effect only If the file is being cached. 
That is, MODE 2564 {is set, the file's UFD entry is marked 
for caching, or caching is set for all data on the system. 
Note that sequential mode data caching requires a cluster 
size greater than 1, although no error is returned If the 
eluster size is l. 
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phen MODE 20488 Is specified In an OPEN statement, data 
stocks from that flle, placed in the cache as a result of 
that OPEN, are not subject to the minimun residency. 
Hovever, MODE 28483 overrides the minimum residency only for 
that file's data blocks, not for the entire cache. That is, 
when data blocks from a sequentially cached file are placed 
im the cache, a read on the last block of the cluster causes 
it to become the "oldest" data block in the cache. It is 
the first to be replaced when the monitor seeks to place new 
data blocks in the cache. MODE 2048% has the effect of 
speeding the replacement process in the cache and thus 
minimizes the space required by the cache. 


As an example of Sequential cache operation, consider a 
GET statement that is executed on a file opened with MODE 
2304812568 + 20484). When a read on the cached file occurs, 
the monitor examines the contents of the cache te determine 
if the requested data item is present. I£ the data is in 
the cache, the data is copled from the cache cluster that 
contains it. The data is made available to the program, If 
the data is in the last block of a cache cluster, that. 
cluster Is made available for replacement In the cache. 


When a read operation is performed on the first block 
of a cache cluster, the monitor Installs a full cluster of 
data in the cache. That is, if the system manager sets a 
clustersize of 8 for the cache, the requested data block 
plus the next 7 contiguous blocks are read from the disk 
into the cache. When the last block of the cache buffer is 
tread, the cluster is immediately made available for the 
installation of new data as requested by other read 
operations. ‘ 

If the GET statement causes more than one cache cluster 
to be read, all of the requested data. blocks are made 
available to the program but only the last cache cluster is 
installed. Wowever, If the last data block read is the last 
block im a cache cluster, no data 1s InstaYled in the cache. 
Thus, {f the cache cluster size is defined as 1 and 
Sequential mode is specified, no data blocks will be 
installed in the cache (i.e., every data block is the last 
block in a cache cluster). 
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Table SOF-1. (Page 1 of 2) 


Manager 7 Non-Privileged 

epece ecaeton Programming Options 

through 

UTILTY Random Cache Sequential Cache 


DISABLE 
CACHE 


No data caching * 
available 


Open file with 
MODE 2048 


ENABLE 
CACHE/ ALL 


Open Eile with no 
data caching modes 


No data caching * 
avallable 


ENABLE 
CACHE/ FILE 


Open file with 
MODE 2648 


FLAG file/CACHE** Open file with no 


data caching modes 


FLAG Elle/ 
NOCACHE** 


_ No data caching * 
available 


No random cache 
avallable 


Open file with 
io data cache mode 


FLAG tile/ 
CACHE/SEQ** 


FLAG tile/ 
CACHE/ RAN 


Open Elle with no 
data caching modes 


Open Elle wlth 
mode 2048 


# If data caching modes are specified, no error is 
issued. 


** These commands set and unset data caching bits in 
the disk directory structure for the file. 
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wanazer 
Specittcation 
through 
UTILTY 


DISABLE * 
CACHE 


ENABLE 
CACRE/ALL 


ENABLE 
CACHE/ FILE 


FLAG flle/ 
CACHE 


Flag £lle/ 
NOCACHE 


FLAG Elle/ 
CACHE/SEQ 


FLAG file/ 
CACHE/ RAN 


Table SOP-1. (Page 2 of 2) 


Privileged 


Programming Options 


Random Cache 


Enable cache SYS 
call ** 


Open Eile with 
MODE 256 *** 


Open Elle with no 
data caching mode 


Open file with 
MODE 256 *** 


Open file with no 
data caching mode 


Open Eile with 
MODE 256 


No random caching 
available ***** 


Open Elle with no 
data caching mode 


Sequential Cache 


1. Enable cache 
S¥S call ** 


2. Open Elle 
with MODE 
256 + 2048 
hehe 


Open Eile with 
MODE 2048 


Open fille with 
MODE 256 + 2048 


waht 


Open file with 
MODE 2048 


Open file with 
MODE 25642648 


Open Eile with no 
data caching mode. 


Open Eile with 
MODE 2648 


* USE LIST CACHE command to check ff£ disabled. 


** Enables data caching for the system. 


‘i SOF-69 


CMPASY CONFIDENTIAL 


OIGETAL ASTS/E V7.8 SAS PLATE 


ene 


erat 


eoetea 


Software and ASTS/E V7.8 


The FLAG £1le/CACHE UTILTY command or the flle. 
utility SYS call can be used, but this makes random 
and sequential caching of the File avatlable to all 
users. 


The FLAG E1le/CACHE/SEG UTILTY command or the file 
utility SYS call can be used, but the file will be 
cached sequentially for anyone using the file. 


The FLAG £le/RAN UTILTY command or the file utility 
SYS call can be used. 
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fEetending Files Opened in Update Mode 


° 


To extend the fille: 
a. Open the Elle in update mode (MODE 1 or MODE 5) 
b. Read in the first block of the file. 


ce. Explicitly lock the first block using the SPECY 
function, 


d. Extend the £fle by writing beyond the end of 
file. 


@. Release the explicit lock on block 1 using the 
SPEC’. function, the UNLOCK statement or the 
CLOSE statement. 

Note 


AS extended blocks are written, they are 
made available to other users. 


Programs attempting to read block 1 
ducing this process receive ?Disk Block 
is Interlocked errors. 


Example 


Create the file : 


1068 OPEN “UPDATE.DAT<¢48>" FOR OUTPUT AS FILE 18 & 
\FIELD #18, 20% AS N.AMES 
1016 FOR I = 18 TO 28 6 A 
\INPUT "RECORD"; NS & 
\LSET N.AMES = NS & 
\PUT $18 & 
\NEXT 18 
32767 CLUSE 10 & 
\EXD 


Reaoy 
Figure SOP-7. Create the File 
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SISLsTAl ASTS/£ VIL8 Sas cPracye 
Sottwace an3 ASTS/E Pie | 


Look at Directory 


pie Grose catzs ’ - 
see fat re cok eceae Date Tie 
sertldte ns e «6Che RIS Poe Op/re 


UPDATE.OAT 20 ¢ G8) 28-Nov-70 20-Wov-78 12132 PH 
Totel of 2 blocks In I file Sn S¥:(10¢,7] 


@ paser 23122 878 


Ready 


Figure SOF-8. Look at Directory 
Extend the fille 


1098 Ow ERROR GOTO 19868 
1018 OPEN “UPCATE.DAT" AS FILE 14, HODE 58 
1615 FIELD @14, 209 AS NAMES 
1628 GET #14, BLOCK 1 6 

\I1G = SPECE(4¢,6%,10,01} 


1930 LSET N.AME$ = “NEK RECORD* & 
\PUT #14, BLOCK 174 


1048 14 © SPECU(34,19,19, 00) HRELEASE BLOCK 1 & 


\GOTO 32767 
i9eee6 PRINT ERR & z 
\RESUME 32767 : 
32767 «CLOSE 1% & 
XEND 
Ready 


Figure SOF-9. Extend the Fille 
Look at Directory 


DIR UPOATE.DAT/S 


Hane JExt Size Pret Access Bete Tt! 
S¥:4108,7) se Cle ATS Poe Op/re 
UPDATE.CAT Ww 


< 48> 20-Hov-78 28-Nov-78 22:92 on 


@ Sasdy 23121 1/80 
Total of 17 blocks fn 1 file tn S713186,7) 


Renny 


Figure SOF-18. Check Directory 
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TEXPLICIT LOCK ON BLOCK ls . 


! ae I) 


BETS STL e Cal SELATE 
Cattware ant RLTL/E V7.2 


pieces Files 


ye2e 


190s8 
isele 
52767 
Ready 


Specify the device cluster number on the /POSITION 
switch of the tlle specification, 


J EXTEND RODE t 
EXTEHO 
\ OF ERROR COTO 19988 EPROR TRAPPER ‘ 


INPUT TFILEMAME EXT" PILS GET NARE.ERT t 


1 

NPUT "PILESTLE (BLOCKS) °yStze 1 GET SIZE ‘ 
: ieeur “DISK POSITION" ;OEPS 1 CLT POSITION t 
N SPES@PILS 67 CARD 767 /POSITIONs* 40TP$ U SET UP SPEC e 
\ OPEN SPE$ FOR OUTFUT AS FILE 1%, 1 OFEN SPCC ry 
PILESIZE SELC, MODE 164 1 NODC ABD FILESIIA 
\ CLOSE 18 4 CLOSE 1T ‘ 
PRINT “FILE HAS BEEN CREATED!® t DONE 
\ GOTO 32767 t EXIT t 


PRINT "NO ROOM OW DIST FOR FILESIZE °+ 
HUMES (S120) 4° TRY AGAIN® 
\ coro 1018 


NOT ENOUGH ROOM & 
TELL USER & 
GO TRY AGAIN ‘ 


Ip ERNeAL THEW RESUME 19368 


NO DISK SPACE & 
ON ERROR COTO 8 
END 


DISABLE TRAP ’, 


Figure SOF-l11. Placed File 
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Using Tentative Filles 


o Specify MODE 32 in an OPEN FOR OUTPUT statement. 
OPEN "Efle,ext" FOR OUTPUT AS FILE 1%, & 
MODE 32% 
° System Actions 


If the file specified already exists, the 
tentative Elles 


- Is “marked for deletion" 
~ shows only in a slow listing of DIRECT 
- Example 

Dee Cecate.* 


Rare .£rt Sise = Prot Date rs (100,7) 
UPDATE, 0A1 17 € 48> 28-Nov-78 


Zotal of 37 Blocks in 1 Cile in S¥1]1e@,7) 


Ready 

EIA CPDAIL.*°/S . 
Kame .fnt Site Prot Access fate Tine Clu RTs Pee Op/re 
$y:3200,7] 

UPCATE.CAt” 17° € 40> 20-Nov-78 20-Nov-78 $2192 PM | Op DASEP «23122 076 

UPTATE.CAT® t € 80> 20-Nov-78 26-Nov-78 021846 PH OQ oasar ----- 1/08 


sotas of 17 blocks In 2 flies tm Gyr fl10, 7) 


Ready 


Figure SOF-12. Tentative Files 
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278. 


SLtL sb 7h tet SELATE 
Gattware ant RLTLSE F7.k 


wnen tne tentative file Is explicitly CLOSES, 
the original file 4s deleted and the tentative 
file is renamed. 


Note 


If the tentative flle is not explicitly 
CLOSEd, is CLOSEd with a negative channel 


number or if the system should crash, the 
original file remains intact and the 
tentative Elle is deleted. 


1000 


1010 


1020 
32767 


e Example 
OPEN “BOOK.LST” FOR OUTPUT AS FILE 1%, MODE 22% & 
\OPEN "BOOK.LST" AS FILE 2%, RECORDSIZE 32767%«1%+2 
FIELD #1%, 30% AS BOOK.TITLES & , 
\GET #22 © SWAPS(IZ) & 
\LSET BOOK. TITLE$ = "PDP-11 COBOL REFERENCE MANUAL? & 


\PUT #12 
CLOSE 1% 
END 


Figure SOF-12A. Tenative Pile Program 
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Making Contiguous Files Non-Contiguous 


OLD MONCAT 
Ready 


LISTNK 
190 EXTEND 
500 OW ERROR GOTO 19000 & 
NEL wy -1f F 
1000 OPEN "CONT.OAT® AS FILE 1% 8 
\FIELD 61%, 20% AS BLAMES 
1010 INPUT "WANE": WS & 
NLSET NAMES o WG 
10206 UT #18, BLOCK 20 & 
\ZOTO 32766 . 
2000 VS 2 STS(CHRS(6S)+CHRS(-262)5CHRSCISDOCHNS(325)) & 
\GOTO 1020 ; 
19000 «soIF ERL » 1020 & 
THEN PAIAT “ERROR NO." ERR: “WITH ES e *; Ef 8 
VEE s OF § 


NRESUNE 2000 
19010 = CLOSE 1% 8 
\OW ERROR GOTO 0 
32766 + §=CLOSE 11 
32767 = ERD 


DIR CONT. DAT/S 
Nave Eat Size Prot Aceess Date Time Clu ATs Fos Op/rr 
$721,235) . P 
CONT .DAT 16C ¢€ §0> 22-Mar-79 22-Mar-79 11:31 AM = 8 BASOF 13702 0/0 
2 ' 


Totel of 16 blocks in 1 lle in $¥:{1,235) 


Ready 


RUM NONCHT 
WAME? HARAY JAMES 
ERRIA WO. 10 WITH EZ = 1 


Ready 

OLR CONT .DAT/S 

Mase .Ext Stre Prot Access Oste Time Clu RTS Pos Op/rr 
$T:(1, 235) 

CONT OAT 20 © 60> 22-Mar-79 22-Mar-79 11:35 AM «68 BASBF 13702 0/9 


Total of 20 blocks 1n 1 file tn S¥:£1,235] 


cy 


Ready 


Figure SOF-13. Contiguous Files 
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ee 
frei the 


weing Non-File Structured Block Mode 
waing 3 


o aAvallable on large ftle systems only 


° Specify MODE 128 on OPEN 


Each GET/PUT using the BLOCK modifier accesses a 
logical block rather than a device cluster. 


Note 


Block number 1 is the first block of the 
MFD on ASTS/E disks. 
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tTAL RSTS/E V7.2 Sas yetace pret teen ge 
Softwate and ASTS/E vile gent ee : tudteate ans rit 
lwe)0 oes IECEO we 4 
\ ON ERA ON 1920) ERROR TAAPPER a 
325) FoR 4-107 98 PCR feet sg 
CARS IS - G ‘ : ie 
een (20) 4RP1S (11) FOR ZH10 TO 38 ; WE ON : “eee ent enact! Dasara : FEET OI ‘ 
\ CARS (ton ereeg* 1 aND THE TENTH 6 Se eee cent sare apc eee. A 
N FORMLINES**0¢a  \SSSPACES (NDS f FORMATS rs eS een aati, fee ake TSR Icecltius ok 
" gous $S0t,ee FO SSt,see.ee 1 REST OF IT t peat) leo It ‘ 
\ HEDS*°CAR MAKE § MODEL 6 STYLET* I HEADER ‘ : NER s 
SPACES{12914° PART PRICE OH EXTENDED VALUE"! POPE OF SAME 4g ‘ Pere ‘ 
AVALFORS=°TOTAL VALUE"4SPACES (430) 4°SS 0,000, 008.8071 VALUE FOPPAT & Meee e) ee 
1922 @3@0 THEN RESUME 1090 { ABORT JOO t 
eld INPT READ FROM WHICH DISK (DONT) * DSRS t GET iNpur DISK ¢ Se eee 
\ UPEX DSKS AS FILE 18,000 1284 1 BLOCK MODE NFS « 19999 OS ERROR GOTO ¥ ¢ JUST IN CASE r 
Woe FIELD 011,20 AS CAR.IDS, ( KEY Fret t 32767 BD 
20 AS PART.NUS, 1 PART CODE t 
Jat As DES, 1 DESCRIPTION sg Ressy 
84 AS UNIT PRES, 1 PRICE EACH ‘ 
29 AS QUAN.AVAS, 1 QUANTITY Of BANDS RUN : 
4640 AS RESIS, 1 REST OF RECORD & READ FROM SHICH DISKIO0N:)? DML: 
20 AS LST.BLKS, : f LAST BLK THIS IDE CAR ID COC + 86a 
20 AS NXT.BLKS 1 HEXT BLK THIS 106 NOBER OF «CORDS TO PRINT ? 15 
PRINT REPORT TG ? EB: 
10Je —INPLT *CAR ID CODE" ICARIDS 1 GET WHAT TO READE TAR MAKE 8 POGEL & STYLE PART PRICE «CH EXTENDED VALUE 
POR NEL TO a } START VALIDATION, 
N GOIG 1349 IF CARS (KU) <CARIDS 1 FouD IT 6 688 FIAT 124 4DR SEDAN PART 4531 $78.09 67 $5,285.63 
\OSEKT xt 1-TRY AGAIN t 688 FIA 124 4DR SEDAN PART 4397 $72.42 39 $2,826.7, 
\ PRINT "7 INVALID CAR ID Cone." 1 WRONGO t 688 FIAT 124 4OR SEDW PART 4211 $61.96 89 «$5,461.04 
\ a0 WN t TRY AGAIN ‘ 688 FIAT 124 ann SEDAN PART 2066 $21.78 £8 $956.56 : 
666 FIAT 124 408 SEDN? PART 3785 $98.6) SL $5,039.13 
W0ge BLXextalt I STARTING BLOCK ¢ 865 FLAT 128 40 Sete! PART 7165 $33.75 $7 $3,979.7 
\ INPUT “SUMGER OF RECORDS TO PRINT “SH.RECR =f PRINT CONT & 868 FIAT 124 40R SEDAN PART 4156 $38.99 11 $39.93 
\ INPUT *PRINT REPORT TO *yREPOS } OUTPUT DEV/TILE & 868 FIAT 124 AGR SEDAN PANT 9598 $17.89 44 $785.32 
\ OPEN REPOS AS FILE 28 UREPORT PILE OG 885 FLAT 124 4DR SEDW PART $555 $71.59 47 $9,364.73 
\ PRINT 174. HEDS { PRINT HEADER = § 688 FIAT 124 408 SENAY PART 22230 -$73,09 38 $2,777.42 
\ PRINT 924 1 BLANK LINE t 860 FIAL 124 ADA SEDAN PART 306? 3 a Ren 
: $98 FIAT 124 apn SEDAN PART $899 «$36. 2324, 
1882) FOR Ct 4=19 TO WLRECE { LOOP FUR PREC ok @68 FIAT 124 ADA Sebel PART 7430 $43.52 90 $4,090.68 
\ GET OLE BLOCK BLK 1 GET TYPE IST BLXe 888 FIAL 174 40R SENAY PART 4605 $41.58 94 $8,412.20 
\ OOTD 1699 IF CVISHINXT.BLKS}© -18 $ B/D OF BLOCKS & 688 FIAT 124 ADA SEDAN PART 069) $94.81 39 $3,697.59 
\ O1CVISt (QUAN AAS) { CONVERT QUANTITYG ~~ 
\ PCVISF UNIT. Pru) 4 CONMTRT PRICE 6 TOTAL VALUE $41,489.57 
N verrat 1 QMUTE VAWE & TOTAL RECORDS: 15 
\ PRINT 920 USING FORMLINES, 1 formar ‘ 
CVTS4ICAR, 10S), § PRINT CAR TYPE ¢ Ready 
pescse" *, P DESCRIPTION = «g 
CVTSU(PART.MOS), : L PART SER gg 
. b Wut price t 
v Lunn inuiee Figure SOF-14, NFS Block Mode (Page 2 of 2) 
\ omveorens 7 $ BLIMP BLOCK COUNT : 
\ VALUL-VALUESY 1 SUM UP VAWES «¢ 
NBL -CV154 (NXT.BLAS) t NEXT BLOCK t 
\ NEXT CT 1 NEXT PLEASE ot 
ft ALAN LTR ® 


Figure SOP-14. 
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RMS-11 V1.8 and RSTS/E V7.6 
General 
DEFERRED WRITE 
© Avallable to user through MACRO and COBOL 


o Used by RMSCNV utility automatically 


MASS INSERT 


© Available to user through MACRO and COBOL 
° Used by RMSCNV utility through a switch 


NEW DATA TYPES POR KEYS . 
° Packed decimal 


o 2 and 4 byte signed and unsigned blnary 


FILE SPECIFICATION 
© Standard RSTS/E Eile specification without 
switches supported 
OVERLAY DESCRIPTION FILES 


o RMSRLS.ODL Resident Library for 
sequential £lles only 


o RMSRLX. ODL Resident Library for 
sequential/relative/ 
indexed Elles 


° RMS11S.0DL Disk Library for ° 


sequential/relative 
filles 
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CLTIsL ST.L2 cel GRUATE 
f.ware ant RLTU/L S722 


° RMS11X.0DL Disk Library for 
sequential/relative/s 
indexed Eiles. (9Kb) 

: o RMS12X.0DL . Disk Library for 
sequential/relative/ 
indexed Eiles. (11Kb) 


Implementing New ASTS/E Peatures under RMS-11 V1.8 


Table SOF-2. 


Feature How Supported 


Large files o Pre-extension through RMSDEF. 


o Explicit or implicit 
extension of non-contiguous 


filles, 

Data Caching Through UTILTY 
Extending non- RMS-11 automatically handles 
contiguous Elles : 
Opened in update 
mode 
Placed filles Through RMSDEF 
Tentative files Unsupported 
Making contiguous Through UTILTY 
Eiles non- 
contiguous 
Non-ftle structured Unsupported 
Block Mode : 
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BASIC-PLUS-2 V1.68 and RSTS/E V7.0 


Commands 


SHOW - V1.60 


o Lists the current compiler defaults 
° Example 
‘9430 
O9TSE MATES PLVS 2 101.97 weing FPR - BF 2 
testatles ef 23-40r-7F ot 2912004 
Meveg far Bee or FTSC te FPeES? 
Meseg Tre WILD te LOL PP ICT 
OOSS2e? Peonsert Llorery te ele 
Stee 1s US: feytoW 
ang Sete te LO: esate 
PPS Peeisent Iterors a9 LO: ReSRES 
fase 28, « 999% 
Bele factre « 3 
Prorsgian « Stingte 
Sottam settioge: 
“ue 
ser 
J ° 
tine 
st8u3 
Jetovr TSE with evereisze ts COs 
Tide ocgo:teate Pive compativie ent 
FRII? 
Figure SOF-15. Show Command 
ASSIGN/REASSIGN . 
o ASSIGN DEV: [ppn]LIB Associates the logical name 
LIB with a device and account number 
BRLAES 
© Allows the BASIC-PLUS-2 resident iibrary to be 
linked to your program during task building 
° Example 
BRLRES 


FILE SPEC (NONE) -- BASICS 
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OSKLIB 


ODLRMS 
° 


be) 


RMSRES 


° 


BUILD 


Allows the BASIC2 or BP2CO4M disk library to 
linked to your program during task building 


Example 


OSKLIB 
FILE SPEC [LB:BASIC2)-- 


Allows selection of AMS-11 ODL Files 
Example 


ODLAMS 
FILE SPEC [L8:RMS11S}] ~-- LB:RMSRLX 


be 


Allows an AMS-11 resident llbrary to be linked 


to your program during task dullding 
Example 


RMSRES 
FILE SPEC [NONE] -- RMSAES 


Accepts new switches 


/BRLRES:ElLlespec 
/DSKLIB:f ilespec oy 
/ODLRMS: Eilespec 

/PMSRES: £blespec 
EXTEND: n 
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Statements 
PRINT, RECORD 


° PRINT with RECORD option supported 


EXTEND/NO EXTEND = V1.5 


o Recognized by compller 
o No action taken . 
o Allows RSTS/E CUSP compatibility 


. CLOSE -Nt 


° Supported for fFlles opened as tentative with a 
HODE switch on the file specification 


Systea Function Calis 


o All the following new and enhanced system 
tunction calls are supported 


- File Name String Scan 
- Get Monitor Tables II : 
.- Change System Date/Time 
- Directory Lookup 
~  Assign/Reassign 
Deassign 
- Wild card PPN Lookup 
-  Enable/Disable Disk Caching 
File utility 
Resident Library 
- Return Job Status 
Create a Job 
- Exit and Clear Program 


o Unsupported System Function Call 


- ‘€xecute CCL 
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txplenenting New RSTS/E Features under BASIC-PLUS-2 v1.68 


Table sof-3. 


Feature How Supported 


Native Mode * RMS 
Large Files Same as BASIC-PLUS o Pre-extension through 
(Virtual arrays RMSDEF. 

limited to 65535 o Explicit and implicit 
blocks) extension of non- 
contiguous files 


Data Caching Through UTILTY or SYS calls 


Extending non- Same as BASIC-PLUS RMS automatically 


contiguous files handles 
Opened for Update ; 
Placed files {Same as BASIC-PLUS Through RMSDEF 
Tentative files Same as BASIC-PLUS Unsupported 

or 

TEMPORARY Keyword** 
Making contiguous| Through UTILTY or SYS call 
files non- 
contiguous 
Non-file Same as BASIC-PLUS Unsupported 
structured Block : 
Mode 
* BASIC-PLUS compatible i 
** New handling for RSTS/E V7.0 
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using the RMS Resident Library 


° 


RASTS/E VIP Sas SPOATL 
Softwace and ASTS/E V7.8 


Preliminary requirements 


-b. 


Ce. 


a. 


Resident library support must be configured 
{nto the monitor. 


The resident library must have the correct 
protection code. 


The resident library must be added to the 
system via UTILTY or the system Function call. 


RSX directive emulation In the monitor {fs not 
required by preferred. 


Procedures for using the resident library 


BUILD and task build procedores 
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SOPGAMEEATEOG POTEEED FITTED e 


“mae OWLY, ACCESS SPITE RS 
TORBMARY 99, ALTE 
aso PurgT TADENTIFVCATS & 
Sivpsr *COLtt; 998 
AENPIT TLICATID 
NIMPUT TAMGUNTT: =D 6 

\puT 2 


Ltigb t.7 val cho 


OTe 
Sofiwate ans tl To/E e722 


AD DSPLICATES 
7 ABS 


% 
$00 LC PWPUT SREOTHER PESORD"; AWSAEPS 4 


NIF AWSZERS a “TES* THES 850 
32767 «= CLOSE 24 8 
AEND 


Fruicz 

NESEG 

Name (FPUCIW)--NONE 
Account [L6:J-- 

Fest? 

AMSAES . 

File spee [LU AMSRES]-~ 
Frye? 

OOLAMS. 

File spec (LA:ANSELK)-- 
fruic2 

BUILD EI02871#O 

reuic? 

consons/200 

Frurez 

tee @110248 

FPUtc2 


num tloze 


IDENTIFICATIONT FAILS 
CONT? Thr 

Locariow? c3$ 

AMDUNTT 93278 

ANDT4ER RESCH? TES 
PIEWTELECATEOWT WATERS 
CODE? OP 

LOCATION? 397 

AMDUNT? SETS 
ANOTHER RECORDE WD 


Figure SOF-16. BASIC-PLUS-2 (page 1 of 2) 
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Feutc? 


OSP ONLT.MAS 


STsCtQO,120TINLT.MAS FILE ONGANTTATION: IWOEXED 
PICLOSIE VERSION BUNBERs t 
CULATED: 22-MANATOTH C9259 
FLLE PROTEST IOwe «60> 
MEISND FOOFAT: FUIEDES? 
PECOMS RTEMLISTES! CAMRTACE RETUAR 
TILE ATIAISUTES: 
ALLOCATIONS TP = EXTEWO QUARTITTSO QUCKET SIZE=? 
HINSER OF ETS! 2 
Feuic? 
ote 
*rroze. co 
ST: 11OZe PE PSST: LLO2N SMP 
YMITS 0 12 


O35 9 ST25297 7819s 10s NTs 12 
ATSLLS OLS: AMSRES/ RO 
ENTISKe 1078 
at 
*rit28 900 

MOOT SASTC2-BNSHOT-USER, SMSALL 
usta: -FCTR ST: 11O298-LIBR 
cist: <FCTR COSFPUCOM/LE 
acarfeutce 
2.9: ANSALE 

£0 
ovr 


FRUIC? 


Pigure SOP-16, BASIC-PLUS-2 (page 2 of 2) 
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Me Software and RSTS/E V7.8 


COBOL V4 and RSTS/E V7.8 


General 


PERFORMANCE 


° Improvements for CPU bound tasks through 
COMPUTATIONAL data formats. 


Note 


1/0 bound tasks are affected very little. 


DATA FORMATS 
o COMP -- PDP-11 binary format 
o comMP-6 ~-- Called COMP under previous releases 


o COMP-3 -- Packed Decimal 
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Removal of Data Item Length Limitation 


Previous to this version, the maximum length of any 
data item (group item, elementary item, or table) was 4895 
characters. This limitation has been removed. Data item 
sizes ace therefore limited only by the amount of memory 
avallable to the executable task and with the conditlon that 
all Data Division entries must be co-resident 
(non-over layable). 


Improved OTS Error Messages 


COBOL-11, Version 4.8, includes a completely new 
object-time system. Error messages have been revised to 
provide clearer and more complete information. The new 
messages ceplace those contained in Appendix J of the pDP-11 
COBOL User's Guide, Order No. AA-1757C-TC. The next” 


tevision of the User's Guide will include the new messages; 
however, they have been designed to require no additional 
reference. 

Error message 15: 

CBL -- 15: STOP RUN 


no longer appears at program termination. 


COBOL Interactive Debugger (CID) 


The COBOL Interactive Debugger (CID) is an interactive 
debugging aid released with. this version of PDP-11 COBOL. 
By using CID, which you include during the task-bulld 
process, you can: ‘ 


o Examine and change data in your program during 
execution. 


° Set and cancel breakpoints, 
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Betieb vt. fa CRUATE 
ftwere and ELTL/E 67.2 


° Change program flow. 


C1D allows you to find program errors without 
ceconpiling or changing your progran. When you want to use 
CIF, you need only task-bulld the program with the CID 


module, then execute it. 


Statements 


ACCEPT 


‘ 
The ACCEPT identifier FROM DAY statements has been 
changed to agree with its description in the PDP-1) COBOL 


Language Reference Manual. Therefore, section 6.7.1 of the 
PDP-11 COBOL User's Guide will be revised to reflect this 
change. 


SOF-91 COMPANY CONFIDENTIAL 


DISITAL ASTS/E Vi. Sas wPlace “af BTL VIF feel LUE TE 
Software and ASTS/E vt.g 2 22 i ssi(‘il = Sut 


Implementing New RSTS/E Features under COBOL v4 Using the RMS Resident Library 


o Preliminary requirements 
Table sor-4. “ 
a, Resident library support must be configured 
into the monttor. 
Feature How Supported 
b. The resident library must have the correct 
protection code. 


Large Files o Pre-extension through RMSDEF. 
ec. The resident Library must be added via UTILTY. 
o Explicit or implicit exten- 
sion of non-contiguous Elles. d. RSX directive emulation in the monitor is not 
: required but* preferred. 


‘ 


Data Caching Through UTILTY o Procedures for using the cesident library. 


a. Merge and task build procedures 
Extending non- PMS-11 automatically handles 
contiguous files 
Opened in Update 


Hode 

Placed Files ‘| Through RMSDEF 

Tentative Files Unsupported 

Making Contiguous Through UTILTY 

Files Non- 

Contiguous 2 

Non-File Structured Unsupported : ‘ 
Block Mode : 
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uy enrg 

LEASE ENTER FILE SFECTIFICATIO€ FOR OUTPUT FILE 
TALLER. OL 

PO Uy WANs A LTEAULT ALKGET 

FLEASE ANSUER Trib re Kees OR MELE) 


tO YOY vant aM aBEELVIATED OR BEAGED OlL FILET 
PLEASE ANSUER ACEPREVIATCE + MICEGED © OR HIELP? A 


00 TOW UANT TO INCLUDE fee COROL DE eUCLER (CIRDT 
FLEASE ANSULR TCES' OF Netty © 


PhO TOU WANE TO OVERLAY 179 SUFFORT ROUTINES 
OF USE THE RESECENT 170 LEeKARY? 
FLEASE ANSWER TIES e+ NOU, UK HIELEY ¥ 


PO TOU YaNt 10 Uk THe RESIDENT 170 LIBRARVe THE DEC 
SUFELIED F-O OVERLAY UF COUR GUN 170 OULT : 
PLEASE APSUTE LEC OULAL Arte OCUN CLERLAY) PRIESIDENT LIBRARY) > 


OF MELB TE 
LEASE ENTER FILE SRECIFICATION FOR INPUT OGL FILE 
tettic é 
ORJECT EROGEAN PEFEREMCED FM OCL FILE 1s! 


tactic .Ond 
PLEASE ENTER CECT FALL GRICE ate Pree CN THE FORMATE PEVICPROJEC Fe PROGRABHERD 


any MOFE INPUT Of FILES? 
FLEASE ANSHEF YES? OF MIOF Y 
FLEGSE ENTER FILE SFEL ER SCATION FOR INFUT ODL FILE 


surEe 
HRIETT EFOGRAM REFERCNCOD IN OCU FILE (St 
SLFEW Uk! J 
PLEACE ENTS ORIECT FILE PEVICE ANT FER TW FNE FURAATE BEVICPROJECT FPRUGRAMMERD 
one eurk ferut ott FILES? 
PLEBie cctSuL ee FekS) GF ACO) 
OPE FALL merce ¢ IPL ETE 
HErokE FOL TELE 1G2 PALL TR. OBL 


vente 


Figure SOF-17. COBOL Merge (Resident Library) 


SOF-94 COMPANY CONFIDENTIAL 


aL BATESE VIL2 Tal SRORTE 
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TY IALLIR-OL 
THERGED ODL FILE CREATED ON 23-MAR-79 AT 07232229 
@TALLIC.O0L 
@SLFER.ODL 
ChORJES .FCTR IALL1C. OBJ-SLPER.OBJ-LB! COBOVR/LBSUIORSX 
CHOTS¢t3 «FCTR LE: COBROUR/LB 
«NAME OTSSOYV 
CNYRTS#!E .FCTR LE! COBOVR/LESCONVER 
LUCVTS: .FCTR LESCOBOUR/LEILECVT 
USKIOS$ -FCTR LRISCOROVE/LB:USRSIO 
oTsovs: .FCTR OTSSOU-(CNYRTS—( #LOCUTS) e KUSRIOS) 
@LBIRHSRLX. ODL 
RMS$! eFCTR RHSROT-RMSALL 
ORJRTS! .FCTR CROBJ$-CBOTS#-RMS$ 
eROOT OBIRT$ OTSOVS 
END 


Ready 


KR 

TRE TKR TALLIRr IALLIR=IALLAR/MP 
ENTER OFTIONSS 
TRKESLIBR®RMSRES ERO 

TRED// 


Ready 


Pigure SOF-18. COBOL ODL and Task Bulld (Resident Library) 
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TKBIAL.ISK MEMORT ALLUCATION MAP TKB 07.005 
ZIA“HAR-T9  =—-073:36 


PARTITION MAME & GEn 

IDENTIFICATION $ ¥82072 

TASK UIC s €£,208) 

STACK LIMITS: 901000 001777 0601000 00512. 
PRG AFR ADDRESS: ¥13172 

TOTAL ADDRESS wiNvOaS: 3. 

TASK IMAGE SIZE : 14200. URDS 

TASK ADDRESS LIMITS: 000000 067343 


TKBLAL.TSK UVERLAT DESCHIPTION: 


BASE TuP LENGIN 

000000 057333 057334 24284. IALLAC 

057334 060567 0901234 00668. RI PUT 
057334 061143 Oolelu 00904. RIUPDA 
061144 061144 000000 0000. orseov 

061144 067337 006174 03196. CONVER 
067340 067343 OQu0V0s dv004. LOCYT 
061144 O60113 OUsISU 02536. USRSIO 


Figure SOP-19. COBOL Map (Resident Library) 
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Figure Sor-28. COBOL Map (Without Resident Library) 
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abe Gay ALLUCATINe SAF TAB 07.008 
Ziotane79 vrs3e 


TRBRAL.TSA pace 1) 


#06 SEGAEATS USnSi0 


ase mer LIngass vores uebnis VOSTSO 02536. 
O1SK BLA LIMLISs un00 ls VOOL02 vouoys OvLoUs. 
REFORI ALLOCATION SiavuPsis: 


TITLE IDENT 


oneee were 


SECTIUN 


x PLE Re,T LCL HEL, CON) Oni144 Louvvd oun00. 
BuUSH1d: (HU, 1 UBL ten Ove) 061144 004750 02536. 


Ovld44 VOaTSO 02536, USHSIO 14.18 COBOVR.OLS 


SEALY? (he,0-LCL,neL,cUN) voll4s voundd 900ud. 
sents t(Ke, he edu RELoute? 025406 COYVOO? 00002. 


GLOBAL STRHLLS!E 


QALPHA Obitoa-k = s{UJIL Ob1Le4-ad = SeSuTL 061202-R 


eee TASK BUILUER STATISEIES! 


TUTAL sued eur ReFEMERCES? 338815. 

WUKK FILE SeUS!t ve 

SOHR FIL crates: 0. 

SLZE uF Cuke voubs 21194. WURDS (62. PAGES) 
Kile LF ua FILES LHs4s. buhUS (74. PAGES) 


EckpSen Tee svEropes 
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7E V7.8 


FILE 


Figure SoP-21. Task Bulld Statistics (Resident Library) 
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eee TASK BUILuin STATISAICS? 
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eUkK FILE ReAUS? IY. 
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Figure SOP-22. Task Build Statistics (With Resident 


Library) 
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MACRO and RSTS/E V7.8 
General 
MONITOR CALLS 


o ALL monitor calls are documented in the RSTS/E 
System Directives Manual 


o Aili RSTS/E V7.0 features available through 
monitor calls 


RMS Features 


o Full RMS capability 


Note : 


Use of RT11 directives are not documented 
and therefore are not supported. 


SOF-109 COMPANY CONFIZESTSSS 


RSTS/E UPDATE 
BRP 


Backup Programs 


BrTye GFIRTE 
bacecp Frogravs 


Backup Programs 


_ CONTENTS 


Int roducthonscceccnccccescererscereerreseerrer ee BKP-1 
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New Switches and Options.....-e+s-sererserrrrs BKP-3 
Multi-Volume Example... cceerssreersercccersese BRP-7 
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Example BACKUP in Interactive Mode......e-.-+6 BKP-13 
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Backup Programs 


INTRODUCTION 


Since backup is a major concern fore all systen 
managers, RSTS/E supplies several backup utility 
programs which handle the individual needs of each 
RSTS/E site. 


The new or enhanced RSTS/E V7.8 utilities: 
° Backup and .restore 

- large filles 

- placed files 

- contiguous files 

- attributed flles 

- entire disks 


9 Produce bootable backup media with bad block 
handling 


Decisions must be made concerning which utility to 
use under a given set of circumstances. 


In this module you will learn: 
° The features of the new utility SAVE/RESTORE, 


° The enhancements to PIP and the BACKUP package, 
and 


° When to use SAVE/RESTORE, PIP, BACKUP and 
RMSBCK 


Bypel TOVFENY CONFISENTIAL 


CISrvAL ASTS/E JPCATE 
: Backup Progcans 


PIP PROGRAM 
General 
° Hass expanded from OKw to 1l2Kw, 
° Has replaced PIPSML and PIPEXT, 
° Accepts the /POSITION:n switch to create a4 placed 
file as long as the switch is adjacent to the 


filename, 


co Is the only way to selectively back up large files 
which cannot E£it on a single tape, and 


0 Zeroes large Etles faster than mode 128. 
New features 


o Multi-volume ANSI magnetic tape aupport, and 


o Specification of density and parity when zeroing & 
magnetic tape. 
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New switches and Options 


File Access Sultches 


Switch 


/ ACCESS 


/ASCIL 


/BSIZEsn 


/NEwE Lle 


/NoAttributes 


/PR:NOWARN 


Format 


fac 


7/bS 


/NOA 


Meaning 


For disk input only, this switch 
causes PIP to change the Elle’s last 
access date to the current date. If 
you do not specify this switch, PIP 
preserves the last access date. 


Does a formatted ASCII transfer, 


causing PIP to Ignore nulls, parity 
bits, and rubout characters. 


Used to specify 4 non-standard 
blocksize for file transfers to 
magtape. en is the blocksize in 
bytes to be output. "nh" must be 4 
positive even integer from 18 to 
4096. For ANSI format magtapes 
intended for interchange with foreign 
operating systems, the blocksize 
shovld not exceed 2843. For intec- 
change with RT11 operating systems, 
the default of 512 should be used. 


For disk output only, this switch 
creates a new file with the current 
date of creation and access- 


this switch causes PIP to transfer 
the fille without writing attributes 
to the output file. 


This switch causes PIP to ignore the 
operation if an output file already 
exists and to suppress the printing 
of the error message. 
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Switch Format Meaning 
le Operation Switches Deletion 
/ RETAIN For disk output, thts switch Eee ee 
preserves the file's creation, access Switch Format Meaning 
dates, and creation time. This Is 
the normal default for PIP, but it /DE /DE ; Same as V6C. 


may be changed by an optional patch. 
; /DE:NO(WARN] Causes PIP to suppress the printing 
/RATSename Die avec one pes de : of an error gesapere the Elle to be 
-time em name cs) a : deleted does not exist. 
specified in name. I£ no output file 
is specifled, PIP renames the input 


file's run-time system. File Operation Switches - Listing 
{CREATION /CRE This switch uses the creation date /DI:option :AL Prints the Eilename, extension, and 
for limit checking with the date /LI:option the number of blocks allocated to the 
switehes (/AF, /BE, /ON, /SI, /TO). file, 
‘This is the normal default for PIP, 
but it may be changed by an optional °AT Prints the Eilename, extension and 
patch. : :SA symbolic representation of Eile 
oa tributes. 
/DOLA This switch uses the date of last Sars 


access for limit checking with the 2FU Full listing; print all information 
date switches. : : except file attributes. 


:0A Prints the filename, extension, and 
Attributed File Translation Switch : octal ieptesentation of "elle 
, : attributes. 
/RMS /RAMS:FTN For Input files, translates FORTRAN 
/ANST 7ANSI:FTN carriage control to formatted ASCII. tRT Prints the Ellename, extension, and - 
For non-disk output files, associated run-time system. 


translation Is automatic. 


:SZ Prints the filename, extension and 
/ANST?PRN For Input disk Elles, translates RMS file size {same as :SI}. . 
/RAS: PRN print files to formatted ASCII. 

2wi Prints fllenames only across the page 


or screen. 


File Operation Switches - General 


. /SLOW ?SL Same as /DI:S . 
/IN 7IN Same as V6C. 


7TM:S Prints the filename, extenston, 
f{lesize, protection code, creation 
date, and last access date. 
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File Operation Switches - Zeroing 


Switch Format Meaning 

/DENSity /ZE/DENin For magtape only, this switch sets 
the tape density prior to the zero 
operation. 


/PARity /2E/PAR:0DD For magtape only, this switch sets 


7ZE/PARIEVEN the tape parity prior to the zero 
operation. 
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Multi-Volume Example 


. Consider the £ollowing example which transfers the 
contents of a user account to three magnetic tape volumes: 


RUN SPIP 
*MMO:* .*=(20, 254) *.*/BL 


| END OF ANSI MAGTAPE OUTPUT VOLUME HAS 


SBEEN REACHED 


SPLEASE TYPE THE DEVICE NAME AND UNIT 
§NUMBER OF THE DRIVE WHERE THE NEXT 
SVOLUME MAY BE FOUND 


7MMis TAPE 2 


SEND OF ANSI MAGTAPE OUTPUT VOLUME HAS 
4BEEN REACHED 


WPLEASE TYPE THE DEVICE NAME AND UNIT 
$NUMBER OF THE DRIVE WHERE THE NEXT 
SVOLUME MAY BE FOUND 


?MM2:TAPE3 — 


In this example, you specify the block mode transfer of 
all files tn account [28,254] on the system disk to the tape 
mounted on MM@:. When PIP reaches the end of the output 
tape, it prints the dialogue that requests the next volune. 
In response to the prompt, type the device name and unit 
numbec (MMit) and the optional volume ID (TAPE2). PIP 
checks the output volume ID, if specified, and that the tape 
is ANSI labeled and initialized. If the-1D is valid, and 
the tape is ANSI and Eree of data, then PIP continues with 
the transfer. This process continues until all of the 
Specified files on the input device are transferred. 


When the transfer {is complete, PIP prints its asterisk 
prompt. 
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Notes on PIP 


1. 


4. 


Appending filles with attributes 
o Do not merge attributed files with PIP, 


RMS Relative and Indexed Files 


a. Use the /B8L switch for transfer from disk to ANSI 


magtape. 


b. Use no switch for transfer from ANSI magtape to 
disk. 


Note 


The above procedure is for RSTS/E to 
RSTS/E transfers only. - 


c. No switches are needed for disk-to-disk transfers. 
RMS Sequential Files 


a. Wo switches are needed for file transfers to and 
from ANSI magtape. 


b. No switches are needed for disk-to-disk transfers. 
7ANSI and /RMS switches 
a. /ANSI:FA of /RMS:FA on the input Elle specification: 


Purpose - Translate RMS Sequential files to 
stream ASCI{ Elles 


o Takes an AMS sequential Eile with fixed or 
variable length records as input. 


o Strips off the byte count (1€ necessary), 


squeezes out null and rubout characters, and 
appends <CRO<LF> to each record. 
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° Creates a stream ASCII output file without 


attributes. 


Note 


Do not use this switch if the RMS 
sequential €ile contains binary data. 


/ANSISFA or /RMS:FA on the output Elle specif i- 
cation: 


Purpose - Translate stream ASCII Eiles te RMS 
sequential Elles with variable length 
records. : 


9 Takes a stream ASCII file as input. 


° Places a byte count at the beginning of each 
record and strips of f <CR><LF>. 


Ce) Creates a sequential file with variable length 
records. 


7ANSI:FTN or /RMS:FTN on the input file spect£ica- 
tion: 


Purpose - Translate files with FORTRAN carriage 
control characters to stream ASCII 
files. 


° Takes a Elle with FORTRAN carriage control 
attributes as Input. 


° Strips off the FORTRAN carriage control 
characters from each record and appends 
<CRO<CLFD, 


° Creates a strean ASCII file without attributes. 


YW 
* 
had 
1 
wl 
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Note 


Specifying this switch on an output File 
specification produces a ?Bad Switch 
Value error. 


/ANSE:EB or /RMS:FB on the input Elle specification: 


Purpose ~ Transfer RSX type object modules to 
DOS labelled magnetic tape. 


© Takes RSX type object modules as input. 


° Translates the file into RT11 object module 
format. 


Ca or /RMS:FB on the output file spect£fica- 
tion: * 


Purpose - Transfer RSX type object modules from 
DOS magnetic tape to disk. 


° Translates the file Into RSX object module 
format. 


aaa or /RMS:PRAN on the input file specifica+ 
tion: : 


Purpose - Translate RMS print format filles to 
stream ASCII Elles. 


Note 


Currently VAX uses this format for its 
log files. Tf these filles are 


transferred to ASTS/E by magnetic tape or 
through DECnet/E, the /ANST:PRN shquld be 
used since the SPOOL program does not 
recognize this.format. : 
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o Strips carriage control information from records 
and inserts appropriate control characters. 


Note 


Specifying this switch on the output File 
specification produces a ?7Bad Switch 
Value error. 


g. /ANSI:IM or /RAMS:IM on the input file specification: 


Purpose ~ Print map files created by the task 
builder at terminals. 


Note 


7ANSL:FA on the input fille also performs 
this operation. 


o Takes an RMS sequential file as input. 


° Strips off the byte count at the beginning of 
each record (if necessary) 


Note 


Specifying this switch on the output file 


specification produces a 7Bad Switch 
Value error. 
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BACKUP PACKAGE 


New Peatures 


° 


° 


3 


Copying of the index £rom the BACKUP set to a disk, 
Listing a directory Index, 


Ability to run under BATCH, 
Caching of the workfile, 
Sequential caching of the filles being backed up, and 


Residing In an account other than {1,2}. 
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AMALTS.cRP 0 1@ $40 62-Jan-19 AM @2-3a0-29 8 
‘STS .omP 6 80 BS-Jan-79 on ‘ 
PSTABL, 105 4 68) D?-Jen-79 an e 
SSTASL ON © 46 W-Jen-79 AM 27-Jan-29 6 
SISCEN.LOG 40 69) OI-Feb-79 re Fi-teb-29 8 
S1SCeR.CTL % 88 O6-reb-79 am Gb-reD-79 8 
* Atteloutes aetoetated with this file 
Accewnt totel of 278 blecke In @4 files on account (1,295) 
Volvos corel of 298 wlects tn 44 fries tn f accounts on voluee Mme 4 
Aenvenccoeeree Caeneenccvecese 
Figure BKP-3. LIST Mode (Page 2 of 3) Pigure BKP-3, LIST Mode (Page 3 of 3) 
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ASTS/2 ypcace 
Backup Projrans Ba 


a it 
a 
eee 
wd 
re 
ow 
=) 
w“ 


RSTS ¥7.8-95 The ARK Job 35 £81 24-Feb-79 @9,50 An 
e723 

Paseverdr = 

09739084 AM Lothar user fa logged in under this eccount 


$JOB : . 09:90088 AM Peady 
$SRUN [1,10] BACKUP 


SDATA Giaesee an nom (hsteyencror 
BACKUP 09230005 AM DACRUP RT.C-03 RESTS V7.0-85 The APE 


eacenecenene: SDATA 
89:301O6 AN BACIROF), RESITONE), LOALOIWOER, OM LISIT} 7 SACKUP 


09090007 AM WORK FILE WANEC Stef 1,79S/67HPER.I25> 7 


{1,235)*.*/EXC: (* .BAK,*.J25) 


89990097 AM LISTING FILEC WBs> ? 


£9230,08 AM FROM DISKC S¥i> ? 

05020088 AM PROM FILESC] 1,229)%.°> PF F1,29S)%.*/E RCE Co. BAN.S 2S) . 
9038128 AM 70 OLVICEC wie F 

9929012 AM BECIN ATCE*,*]%.*? 7 

99070092 AM DELETE FILESCNONED P 


: . 03030133 AM COMPARE PILESCHONED ? 
MMG@: . ; : 0502015 AMF 
YES : , 
$SEOD 
SEOJ 


O;30015 AM Backup fun Lieting 


09190025 AM Gachyp free ' fT ur to LMT OD 
BGe5802S AM Run atstted en 20-Pab-79 af 09738 AM 
#9030015 AM Wock-File fe _S¥ eU2, 23570 20FER 225 


09090015 AM Tronefer ¢ 
O9090028 AM AL VISPPPPPEP PITLENCH CLD, DISPPPLIFP.BAR, UL IISPPZIPIP. IST 


CFs 3001S AM Begin oe os 1°,°3°-* 
9.20113 AM Helete a ¢none> 
09530018 AM Compare « «none? 


or tests am ® 


Figure BKP-4. Batch Control File : Plgure BKP-S. Datch Log {Page 1 of 5S) 
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99090173 AR PWAST = «6 LIMP COMPLETE 


of: 


ee3 AM ERRORS on 6 


O9s)0009 am CLAPSED tint 1 @ 
@2,30013 Am Cru Tine 1.4 stcowre 


sid am acts eu 


Or 2en32 AA Oe 


09038077 AN BLOCKS 


e3 
od 
Oooo FP AM FILES + 3@ 
432 
0903003) AM ERRORS ci] 


PARSE — LOCROP/SELECT COMPLETE 


O90dbe7) AM CLAPSED TIME 4 1) BECONDS 
t 


C2eDo FP AM Cry TIME 
CFs200d) AM KCTS 


8913009G Ano 


09030536 AR PLEASE ENTER BACECH SET WAMECBIEFES 


eeconps 


wt IATL 


estrus 


a 


O90ITEIT AM PLEASE EWTER LAPIRATION OATECIS-Feb-O8) ~ 
Oe 100 Fe AM PLEASE EWTER DEWSITY Be Brrcager ~ 
O9e70079 AM PLEASE CWTEA THE PARITTCODD? - 


OF290008 AN MOUNT = DEVICES 
ove30se8 an 10s 

state 
ocwsirte 
VARitTs 


ORVICE? Mate 
101 
StOts 
pewsitre 


PARITTY 
CREPIRATION DATEr 


tarorg 8 


ects e 


WIFE AM ® 


1 
ace art 
ono 


CERPIRATION DATE BAS WOT TET ARRIVEDE 
ereree 


2 

aee prt 
ono 
20-Feb-09 


MOUNT ET ANIWAYCNO>TTES 


paase 1 BQUNT / DISKOUNT COMPLETE 


ELarseD TINA s F SECONDS 
Cro TIME + 3.2 seconpe 


IDENTIFICATION WILL SE FLRAL DPOW SUCCEserUL mOUNT 


99239002 AM CATR OWRELIASLE ~ PILE OPENED BT AMOTHER USER Iw TILE Det ath, 239jBACKO 


Odeitre] AM PLoS 
OF dFcOs AM OM TRARSPER) 


Figure BKP-S. 
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e9e79102 AM? 


ETS/E JPDATE 


Backup Prograns 


09239002 AB LENCTR CHANCE te rrLe pel AU, 2U5/8ACRUP. LOG 


99079007 AM [OH TRAMSFERD 
O70 3FeGD AM 


. 
09:30:62 AM LeRcTs AT LooRUP - 1 Lewctm at TaAmsren - S$ 
* 


09539087 AM 


0919910) AM PRAST of TRANSFER conPLeTe 


es 39:02 AM VOLONE @ et 
Ov.29eep AM ACCOUNTS rf 
09299187 AN PILES +38 
0923910) AM BLOCKS a 226 
09,3903 AM RnroRS ot 2 


O5e3908T AN CURRENT VOLUNE 


09029003 AM ELAPSED TINE 0 19 srconos 


0929900) am CeO TIME ea 


«? secowps 


990393 AM RCTS o 748 


07139109 AM ® 


07039007 AM FUASE «of PROER DUNP COMPLETE 


09539008 AM ERRORS ¢ 


09:39089 AM CORRERT VOLUME ob MMB 
GonI01ed AM ELAPSEO TIME 0 S ELCONDS 
27030009 AM CFU TINE 2.7 SECOWOS 
03079909 AM RCTS ene 

OosI9ete an * 

09029018 AM DISNOUNT DEVICE! weet 
239004 RA ico Bierce 
039078 An Scots DULMOEE) 

090797014 AN OEMSiTTs gee fri 

89079108 Aw PARITTR 000 

OF2IFe)4 AM ERPIRATION OATES 20-Peb-08 

e9099r24 AR PLEASE LABEL TRIS VOLUNE? 


eorele aM * 


O9r3F028 AM PHASE = ¢ MOUNT 7 OLSMOUNT COMPLETE 


29739erd AM ERRORS 69 8 


05039028 AM CLAPSCO TING + J SECONDS 


89,99r30 AB CPU TIME t. 


3 secowns 


O9219:1¢ AM RCTS 2 40 


SHeIHeIT AM ® 


O9:39e1T AM Sechup Set Wane 
OT 0IFIT AN Voluee Sequen 
O90I9017 AM Creation Dete 
09039017 Am Density 


a Bierce 


eos itindesd 


2e-reb-79 


O90 29007 AN Recovat + 11,2359 
OF F9027 am Cluetereize 4 16 


OFr 2711? AN 


Ceeation 


Pigure BKP-5. Batch Log 


ber =>" 


Bectup Bevice + 
Ovnee 6 18,7931 


Cupication Cote & 20-reb-48 


Pectty s OCD 


Quote » sere 


Access 


{Page 3 of 5) 


TIMP ESY 


TONFUDESTIAL 


OLSITAL 


89s 3917 


Oho 29017 
09039227 
09539007 
et: 9rdF 
errors 
9019007 
07,3808? 
Ssentese 


09229228 
69599020 
ovr decae 
99539070 
OF: 99058 
OFs39028 
09099: 28 
04599: 20 
aoeder2e 
ERE Eris 
i] 


Oona) 
0803921 
PTE LIE S| 
O99 
OF: 39022 
09299022 
09599022 
89c99eIT 
O8035229 
€9239522 
09599222 
09: 39077 
090399522 
0999022 
09299022 
09199022 
09:99:22 
09039022 
09099022 
09039022 


OFe 39077 
9299123 
919900) 
99299028 


Fc 39124 


090395246 
00030024 


ASTS/E JPLATE 
Backup Prograna 


at Meee fet Site Pret Date Gate tse @ts Tae 
an tsoyece DIST bs 
an wre our 39 88 89-Nov-76 €}-Rov-?t OQ saser tf 
an Derrit.oas 2 88 t9-Ner-78 O9-wor-70 sxe 
an FFti .ceOP $20 48 = 99-Row-78 89-Nov-78 a . 
AR STS) = .t8T DOP BE-How-78 1s-or-78 J 
an $180) «JUST 2 60) 16-Now-78 A6-now-18 e 
an 6EQ COL 3) 68) (29-Noe~79 29-Nov-18 e 
an $092) .00L 2 68 3S-Nav-Te 27-Nov-76 t 
16¢ 68 @T-Dec-78 #3-pec-78 e 
oe 02-pee-78 ¢ 
4 2 
548 4S s 
WA GA 1S-D0e-78 ' 
20 $8) @1-Jun-76 ' 
1 68) 32-201-7¢ t 
2 05-Sep-78 e 
1 e 
am CCONt ’ 4 
an BONEE 1 a 
an CPOs 1 & 
Ag OCRALH ] 13-Nov-76 
am per 1 21-Wor- 18 21-now-78 
AN MCDT29. BAS t 21-Nov-78 21-8ov-18 
AW VIATD OAS 1 21-Wor-78 21-wev-70 
Am $t2 BAS i 2?-Wor-Ts 27-Nov-78 
ae VIFTUL OAs ! 24-nor-78 3A-tov-78 
CPOCAT. ORE 3 28-Nov-78 20-wov-78 
UPDACC.SAS i 24-noe-T8 24-Wov-78 - 
OPCEET.GAS 1 28-woe-78 38-Nov-78 
troreo.eas 3 28-Nov-16 20-Rov-76 
TEMTL .OAS i 34-Nov-78 39-¥ov-78 
AM TENT .BAS 1 20-Hov- 
AN TENT? .02$ i 93-Dec~ 
AM OPMSC BAS i B6-Dec- 
AN NCHCHT.BRS 1 91-Dee- Tt 
AM TTS .88S i 1$-bec-79 t 
AM EYLPFS.OAS a“ J3-Dec-?¢ Tt 
AM EVLNFS.OAC 18¢ 228 23-ec- t 
am evlers.cee te 8 22-Dec-18 Tt 
AM AMALTS.OmP 19 68) 02-Jon-79 92-Jen-79 tT 
AM ORSTS .OMP $ G8) 1$-Jen-79 I$-Jen-78 . T 
RM BSTASL. 10K a 60) 17-Jen-T9 S}-Jen-19 eatil & 
AM OOSTAPL. DEP @ 66 Fi-Jan-79 H-Jan-19 g@attr f 
AM STSCEN.LEEG a 6@ 3-Feb-79 @i-reb-19 Bc MEET f 
AR STSCEM.CTL © 7 68 06-Feb-719 96 -feb-19 @easer tf , 
AM BCEBAC.LST 13 68) 2e-Fen-79 20-Peb-29 @ easter + 
AM SCRLOR.UST 3 66) 24-reD-79 10-Preb-73 @ easar TF 
am S1F028. 10D 16 66) 18-Feb-79 20-red-19 Gasser 7 
aM DCRLIS.LST 30 GE) 26-Peb-79 20-feb-79 geasir f 
AM BACKUP .CTE b 68) «26-Feb-29 OF032 AN 20-Teb-79 geasar f 
AM BACKOP.LOS S $0 26-Feb-79 €9:90 AM 28-Feb-79 SO taser £ 
AM * ttcors 
AN CATA CMPELIASLE = FILE OPEWED BT ANOTHER TEER on PILE 
an LEWCTA CHANCE on PILE 
an Torsl of 2 errors entountered on PILE 
RA © Attributes aeeeelated vith thie File 
aa Recount totel of 326 Blacks In S$¢ (ilee on account (1,259) 


an Totel of 2 errers encountered on ACCOUNT 


Figure BKP~5. 
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85019924 AN 
09239078 AN 


89039020 AN 


09199024 AN 
09099024 AM 


2907070 an 
OF: 38024 An 
09099078 An 
09599078 AM 
891390748 AM 
09099078 AM 


09739024 AM 
07099039 AN 
09579124 AN 


, 09099075 AN 
09059073 AN 


FSTS/E UPCATE 
Backup Prograns 


Veluee total ef 326 blocks in S@ flies in 1 sccounts on volume AM ’ 
Totel of 1 ecrore encountered on VOLORE 


PYyeI Iti) 


Bum totel of 326 blachea tn $6 Tiles on 2 secounte on 1 Yotunes 
@ 2 ercoce 
ted on 216-Feb-79 st 09039 AM 


ADOSER ODOR OAHAOH ODED EREESEEDEOOD OOO ERSOEREASEODEDELERESTOOEOEOSOOOTO AT 


PRAGE ¢ LIST COMPLETE 
votune @e ] 

aAccouwTs a 

FILES se 

SLoces 9 326 

errors 64 8 


ELAPSED TINE » & SECONDS 


cry Tine + 3,a SECONDS 
ects o Sie 
t 
< ’ 
Ready 


weve rn een = SEO 


09299925 AR 
09:99:76 AB 
89039027 AM 
09039077 AN 
2099027 an 
09039097 AN 
09039027 AR 
09239077 An 
09099027 AW 


OYE 

Conkicws TES 

Saeed all dtek fitees 612 blocks In woe, 468 free 
Job 25 User 2,273 fogged off KBL at 2#-Feb-7F 89:99 AN 
L ether voor still logged In ender this sccount 

Syetes RSTS ¥7,9-85 The ARK 

fun tine woe 23.9 seconds 

Elepeed tine waa } minute 

Good sorning 


Figure BKP-5. Batch Log (Page S of 5) 
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SAVE/RESTORE PROGRAM 


Features 
° D 
isk to disk Image copying with bad block handling, 
° Bootable save set of disk-to-tape or disk-to-disk 
, 
o Runnable off-line in the INIT.SYS environment, and 
r) 


Runnable on-line under the RTI] Run-Time System 
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DIGITAL 


RSTS/E UPDATE 
Backup Prograns 


rules for Using Media 


1. 


2. 


3. 


The IMAGE Function 

a. IMAGE copies can only be made from disk to disk. 

b. IMAGE can only copy between like disks (disks of the 
same size). 

The SAVE and RESTORE Eunctions. 

a. Volumes of a single save set must be all disks of 

} all tapes. 

b. A save set may consist of different types of disks. 

c. Tapes in a single save set must all be weltten at 
the same density. 

Disks 

a. Must be formatted. 

b. Must be DSKINTed 1€ SAVRES is being run on-line. 

ce. Will automatically DSKINT if savr\es is running’ 
off-line. : 

d. The following blocks must not be dad: 
° The first 16 blocks for a save set disk, and 
° The first device cluster and the next 4 blocks, 

where n is the MFD clustersize for an IMAGE copy 
disk. 
e. Must not have more than 15] bad clusters. 
f. Cannot be logically mounted. 


pRp-2? COPEANY CONFIDENTIAL 


ASTS.€ setate 
Backup Proqrans 


Tapes 
a. Must be long enough to hold the: 


° Save set label and header information 
e Bootstrap, and 
° INIT.SYS . 


b. A bad block is considered to be the end of a volume. 


c. The default density is the lowest allowed on the 
first magtape drive used to produce a save set. 


BKP-38 COMPANY CONFICENTIAL 


RSTS/E UPDATE 


. GITAL 
Backup Programs 


SAVE/RESTORE Options 


Table BKP-1. SAVE/RESTORE Options 


Valid for Functions 


IDENTIFY 


RESTORE 


*EXPIRATION 
EXPIRATION: date 
NOEXPLRATION 


VERIFY 
*NOVERIFY 


*STATS 
NOSTATS 


* ERROR 
NOERROR 


* pefault Condition (the default expiration date is one 
year from the date of the SAVE operation). 


are 31 COvPANY CONFIDENTIAL 


ae z 
Ale 4 


Wek srlace 
Barstap Progzsant 


sew Ssavnas 


FAV/AES PurcteencBtlr 


The volsd SA¥/ECS Conctiene sret 


gave Rone @ eafe copy of o ASTESE File-etewctuced disk, 
eestrone Pestece © SSTS/E Fele-etevetwred dies free a SAVE Set, 
trace Copy © volume image frow s RSTE/E Chle-etewcrured dick 


te o Line @iet. : 
soeetiry List tne charecteqlorics of & BAVE Set ef RETS/E Gian, 
weer Print Unie Dist ef acceptable reepansee. 
Only the fitet tve chececzers need be typed. 


SAV/PES Functions IOCHTIFY 
Prom Device? Onde 


Pevicer Ones 
Pech 200 SYSPAR 
Pach Clustecoiaes ‘ 


Creation derer Wednesday, 07-Peb-19 


SAV/RLE Fonction: SAVE 

Vrom RSTS diet? DAEs 

eee pack 1D/delavit Eave Set Nese fa STSPAR 
Te Device? mre FAVEST 

94° Save foc wane te Savery 

Eepiration Bate £29-fob-OOr7 

Vertly t1se er wep (NODT 

Breceed (Tee of Raj? 

7e Inithalising Elcet FAVE volume 


ose Begin SAVE from Ons te Kes at 11000 AN 


Bloeount Bevices 
Set Woner 

Seq tt 

Deneityr 
Ceeotion sate 
Expiration decer 


Pree 
sryvest: 


lees,” 
Tweeday, 20-Tebh-?9 
Wednesday, 29-feb-08 


Plesee label this volume! 


so- SAVE eperetion completed ot 12292 An 


Suemary Report 


EAVE of OMS LHTIFAL te Seve Set SAVEST 


fnpet devices 


Fact Cle 
Creation deter 


Output Oovices 
Set Kawes 
Pet rolveser 
Densttye 


Ones 
SYSTAR . 
a 


Wednesday, 07-Peb-39 


Regqrece 
Gavest 


Figure BKP-6. IDENTIFY and SAVE Functions (Page 1 of 2) 
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DIGITAL 


Backup Progranas 


Teaaday, 29-Feb-79 


Ceestion Gates 
Wednesday, 20-Feb-0@ 


ration dates 


GAYE stacted on fveeday, 19-Feb-79, at 22009 AN 
Bun Btatiotics 
Tronetec Toroles 


Porat of 14936 blecka teonsforred 


Qeree Totales 
Tetal ef 8 new bed blecksa aenceunteced on source. 


Tining Toteler 


Tota) elepeed timer @hes.e @ alos., 
Totel walt theer PB hee., SF wine.. 
Total process tines @ bre... @ mine., 


GAVsREB Fenction: “f 


Ready 
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we 


SISTTAL ASTS/f UPLATE 


Backup Progcans 


RUN SSAVRES 


SAV/RES Function: RESTORE 

From Device? MM@? 

### Save Set Name/default Pack ID is SAVEST 
To RSTS DM: Disk? DM@:SYSPAR 


*** The volume on DM@: is a RSTS disk 
#** pack ID is SYSPAK 


##@ pack will be ceinitialized 
Mount it anyway <NO>? Y 


#** Pack ID ls SYSPAK 
Verify (Yes or No) <NO>? 
Proceed {Yes or No)? ¥ 


##* Begin RESTORE from MM@: to DMB: at 11:17 AM 


Dismount Devices: MMO: 
Set Name: SAVEST 
Seq ft: 1 
Density: 1600 


Creation date: 
Expication date: 


Tuesday, 29-Feb-79 
Wednesday, 28-Feb-66 


Dismount Device: DM@: 
Pack ID: SYSPAR 
Pack Clustersize: 8 


Creation date: Wednesday, @7-Feb-79 


Please label this volumel 


~~~ RESTORE operation completed at 11:21 AH 


Figure BKP-7,. RESTORE Function (Page 1 of 2) 
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ee cseaL EUTOLE 
ad Batkup Fr 
Summacy Report 
RESTORE of Save Set SAVEST to DM@:SYSPAK 
Input Device: ‘Magtape 
Set Name: SAVEST 
# of volumes: 1 
Density: 16006 
Creation date: Tuesday, 28-Feb-79 
Expiration date: Wednesday, 20-Feb-8868 
Output Device: DMG: 
Pack ID: SYSPAK 
Pack Clustersize: 8 
Creation date: Wednesday, @7-Feb-79 
RESTORE started on Tuesday, 28-Feb-79, at 11:17 AM 
Run Statistics 
Transfer Totals: 
Total of 14824 blocks transferred 
Error Totals: 
Total of O new bad blocks encountered on d 


@ files structurally altered. 


Timing Totals: 


SPOLTE 
ogrets 


estination. 


Total elapsed time: @ hes., 4 mins., 6 secs. 
Total wait time: @ hrs., @ mins., @ secs. 
Total process time: 8 hrs., 4 mins., 6 secs. 


SAV/RES Function: “2 


Reaay 


Figure BKP-7. RESTORE Function (Page 2 of 2) 
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DIGITAL ASTS/E SPLATE 
Backup Prograris 


RUN SSAVRES 

SAV/RES Funtion: IMAGE/NOERROR 

From RSTS disk? DBS: 

**¢ Input Pack ID/default Output Pack ID is SOURCE 
To RSTS DB: Disk? DB1:DESTIN 


**¢ The volume on DB]: is a RSTS disk 
eee pack ID is OUTPUT 


#** pack will be reinitialized 
Mount it anyway <NO>? YES 


*** Output Pack ID is DESTIN 
Vecify (Yes or No}? YES 
Proceed (Yes or NO)? YES 
*** Begin IMAGE copy from DB@: to DBl: at 11:92 AM 
*** Begin VERIFY pasa from DB@: to DBI: at 11:84 AM 
**e @ differences found 
Dismount Devices: DB1: 
Pack 1D: DESTIN 
Pack Clusterstize: 8 
Creation date: Monday, 22-Jan-79 


Please label this volume! 


--~ IMAGE copy opecation completed at 11:67 AM 


Figure BKP-8. IMAGE Punction (Page 1 of 2) 
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SE ULTAS EOTIZE JRDATE 
Fachkeo Programs 
Summary Report 
IMAGE copy o£ DB@:SOURCE to: DB1:DESTIN 
Input Device: DBa: 
Pack ID: SOURCE 
Pack Clustercsize: 8 
Creation date: Monday, 22-Jan-79 
Ovtput Device: DB1: 
Pack ID: DESTIN 
ipack Clustersize:: 9 
Creation date: Monday, 22-Jan-79 
IMAGE copy started on Monday, 22-Jan-79, at 11:02 AM 
Run Statistics 
Transfer Tetals: 
Total of 24400 blocks transferred 
Error Totals: 
Total of @ bad compares. 
Total of @ new bad blocks encountered on source. 
Total of ® new bad blocks encountered on destination. 


@ files structurally altered. 


Timing Totals: 


Total elapsed time: 8 hes., 5 mins., 22 secs. 

Total wait time: 0 hes., 6 mins., 8 secs. 

Total process times @hes., 5 mins., 22 secs. 
SAV/RES Function: “Z 


Ready 


Pigure BKP-8. IMAGE Function (Page 2 of 2) 
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Additional SAVE/RESTORE Documentation 


The RSTS/E SAVE/RESTORE system program is a disk backup 
and copy utility that provides you with fouc operational 
functions. SAVE, RESTORE, and IMAGE perform the backup, 
recreate, and copy functions respectively, while IDENTIFY 
extracts label Information from a SAVE/RESTORE volume or 
RASTS/E disk. This documentation describes these four 


functions, how they are invoked and how and when they should 
be used. 


When to Use SAVE/RESTORE 


SAVE/RESTORE and BACKUP each possess similac but 
dl€ferent system functions, SAVE/RESTORE was developed to 
provide a non-selective, East volume backup, and copy 
capability that requires few operator responses during the 
operational dialogue. Unlike BACKUP, SAVE/RESTORE processes 
entire volumes only, and does not allow selective Eile 
transfers, oc File deletes. SAVE/RESTORE does not require 
operator Intervention when it encounters bad blocks. For 


these reasons, use the SAVE/RESTORE package when you need 
to: 


1. Create a fast, reliable copy of an entire ASTS/E 
disk, ; , 


’ 


2. vera files that are larger than 65,535 blocks, 
an 


3. Make a fast copy to a disk that contains bad blocks 
which may not be reflected in the BADB.SYS file. 
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Definitions of SAVE/RESTORE Terms 


The SAVE/RESTORE terms defined here are used throughout 
this docunentation. . 


SAVE Format The format of the output written by @& 
SAVE operation and read by 4 RESTORE 
operation. 


SAVE Set _The set of magtapes or disks created by 
a SAVE operation. A SAVE Set must be 
composed entirely of disks or tapese not 
' : a combination of the two device types. 
However, different drive types may be 
mixed within one set, for example, two 
RKOS's and one RKO. 


SAVE Volume . One of the magnetic tapes or disks of a 
SAVE Set. 


SAVE Set Name One to six alphanumeric characters used 
to identify a SAVE set. By default, the 
SAVE Set Name is the same as the Pack 1D. 
from which it was created. You can 
specify another name for the SAVE Set: 
rather than accept the default. ; 


LIKE Disks Like disks are units of the same device 
size. For example, SAVE/RESTORE 
considers the following devices LIKE: 


An RPGS is like another RPOG 
An RMO2 is like an RNOI 
An npad is like an ReOs 
An RKOSJ 1s lIlke one unit of an 
RKOSE : 


e000 


As a fucther clacification, i€ you copy 
an RMO2 to a SAVE Set, that set can 
later be RESTOREd to either an RMA or 
another RMO2. 


hee ye TRWFENY CONFIDENTIAL 


pigitke RSTS. Sas 


wacesp weet 


Running SAVE/RESTORE 


You can Invoke the SAVE/RESTORE program off-line white 
you are running the system initialization code (INIT.SYS). 
To do this, type SAVRES on the console terminal {n response 
to the INIT "“Option:" prompt. After you press the RETURN 
key, SAVE/RESTORE requests the current date and time then 
cesponds with its own “SAV/RES Function:" prompt. The 
following example fllustrates the proper cesponse to the 
INtT "Option:" prompt and the appearance of the SAVE/RESTORE 
Prograa prompt. 


Option: SAVRES 


D9-4M4-¥Y? 12-JAN-79 
HAMM? 12:15 


SAV/RES Function: 


To Invoke SAVE/RESTORE on-line, you must type RUN 
SSAVRES, then press the RETURN key. After you issue these 
connands, RSTS/E prints the SAVE/RESTORE program prompt, 
"SAV/RES Function:". The example that follows represents 
the steps you take to initiate SAVE/RESTORE on-line. 


RUN SSAVRES <CR> 
SAV/HES Function: 
’ 
Once the "SAV/RES Function:" prompt appears, either as 
a cesult of invoking SAVE/RESTORE off-line or on-line, you 
are under the control of SAVE/RESTORE and are ready for 
bazkup processing. ; 


Next, select ‘from the following table one of the 
following four operational functlons: SA[VEl, RE [STORE], 
IM[AGE), or IDENTIFY). Unless you need to exit 
SAVE/RESTORE (by using <LP> or ~Z) or need further help (by 
tyoing HE[LP] or <CR>}, type one of the four operational 
functions on the console terminal in response to the 
"SAYV/RES Function:"” prompt. The following example 
{llustrates this procedure: 


SAV/RES Functhon: SAVE 
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SAVE/RESTORE Functions 
SA(VE) Creates a copy of a ASTS/E file-structured 
5 disk. The SA{VE] function backs up to disk or 
tape. ; 
RE [STORE] Recreates a RSTS/E file-structured disk from a 
SAVE Set. 
IM(AGE] Copies a RSTS/E Elle-structured disk to a LIKE 
disk. 
IDfentif£y] Prints label information and other volume 


characteristics of a SAVE volume or a RASTS/E 
file-structured disk. 


HE [LPJ Prints 2 table of SAVE/RESTORE Eunctions. 


<LF> Press the LINE FEED key if you want to exit 
the SAVE/RESTORE program environment. If you 
{nvoke SAVE/RESTORE with a RUN command, 
pressing <LF> ceturns you to your default 
Run-Time System. T€é you are cunning 
SAVE/RESTORE off-line with INIT.SYS, pressing 
<LE> returns you to the “Option:" prompt 
{ssued by the INIT program. 


<CR> Press the RETURN key and the “Type HELP for 
help” message appears on your terminal. 


"Cc Type “C to produce the same result as pressing 
the LINE FEED key. 

“2 Type “Z to produce the same result as pressing 
the LINE FEED key. 


other Produces the same result as pressing the 
RETURN key. 


Press the RETURN key when you finish entering the 
selected function. This procedure invokes the SAVE/RESTORE 
dialogue. 
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Note that the function response In the previous example 
tepresents only one of three different ways you can answer 
the “SAV/RES Function:" prompt. The response to the prompt 
determines the type of dialogue to be carried out as well as 
the operation to be performed. A description and an example 
of each type of response appears in the following table. 


Table BKP-2. Response Types for 
the "SAV/RES Functions” Prompt 


Response Type Description 


Function 
_ (by ftself) 


SAV/RES 


TE only a function ts 
Function: SAVE 


given, the full dia- 
logue follows 


Function plus 


SAV/RES Functions 
Optlon(s} 


SAVE/ EXP? 16-JUL-79 


f€ the function tis 
followed by options, 
dialogue questions 
will follow only for 
the devices to be used 
and the unspecified 
options. | 


Full Function 
Command Line 


SAV/RES Functlon: 
IMAGE D41:=DM@: 
MYPAK/VER/NOERR 


IT— a complete command 
line is given, no 
dialogue questions 
will be asked. : 


During the run, SAVE/RESTORE Informs you of its 
operational status by printing messages on your terminal. 
Some of the messages are intended for your information: 
others notify you of error conditions that might require 
your attention. This latter group consists of errors that 
can occur during the dialogue, mount, transfer, or 
verifEicatton phases of SAVE/RESTORE. 


When the program encounters an error during a dialogue 
ofr mount operation, it instructs you to rectify the problen, 
then asks you to re-enter the appropriate command. These 
errors never affect the [Integrity of the data being 
transferred. 
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On the ether hand, errors that occur while SAVE/AESTORE 
is transferring or verifying data can jeopargize this data. 
In this case, SAVE/RESTORE cesolves the problen, aborts the 
run, or cequests whether to continue or abort the projran. 
In error situations of this type, the program gives you as 
much information as it can to help protect your data. That 
is, SAVE/RESTORE lets you know what it is doing by Issuing 
{Informational messages as well as error messages to your 
terminal. 


Finally, SAVE/RESTORE prints summary {information about 
SAVE, RESTORE, or IMAGE opecations. This report describes 
the operation performed, device information, run start date 
and time statistics In addition to run total statistics. 
The number of errors encountered during the operation are 
listed as part of the run total statistics. The program 
prints this report at the end of a run. 


SAVE/RESTORE Options 


You can include SAVE/RESTORE options (switches) in a 
function response or in a single line command. The options 
that appear in the following table are of two types. The 
first two pairs of options correspond to SAVE/RESTORE 
dialogue questions and have option defaults. If neither of 
a pair of options is attached to a function response, an 
appropriate question will appear fn the dialogue. However, 
1£ one of the pairs is specified, the corresponding question 
will not appear in the dialogue. If neither of the paic is 
specified in a full function command line, the default is 
assumed, 


The last two options In the table have no corresponding 
dialogue questions. The /ERROR option Is a default setting 
which means that SAVE/RESTORE will print non-fatal error 
messages and continue processing. Consequently, If you want 
to have all errors abort the program, you must attach the 
/NOERROR option to the function response or the Eull 
Eunction command line. The /STATS option is a default 
setting which means SAVE/RESTORE will automatically print a 
summary report at the end of each run. Consequently, if you 
want to suppress the suanary report, you must attach the 
/SOSTATS option ‘to your function response. 
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Table BKP-3. SAVE/RESTORE Options (page 1 of 2) 


Table BKP-3. SAVE/RESTORE Option (page 2 of 2) 


Description 


Default Description 


EX(PIRATICN) (:date] 


EXPIRATION | This option is legal only 


, mit the /NOERRCR 
NOEX(PIRATION} for a SAVE operation. tec peed aed ener 
The date argument that : error occurs during a 
you Insert is the date SAVE/RESTORE- run, an 
after which you may error message appears and 
overwrite the destination processing continues. 
volume. You are warned 
by SAVE/RESTORE of any TE you specify NOEA[ROR) 
attempt to overwrite the and any run-time error 
volume(s) any time prior occurs, the program 
to the specified date. terminates after printing 
r message. 
if you specify /EX{PIR- ets 3 
ATION] with no date 
érgument, SAVE/RESTORE 
establishes the expira- Dhl gave . 
tion date as one year The SAVE/RESTORE dialogue begins after you invoke the 
after the current date. SAVE/RESTORE program and enter a function response to the 
"SAV/RES Functlon:" prompt. TE you respend with SAVE, 
If you specify /NOEX[PIR~ RESTORE, IMAGE, or IDENTIFY, the program initiates a set of 
ATION], SAVE/RESTCRE uses dialogue questions. All questions in the dialegue have a 
the current date as the short form or a long f£orm. The short Form appears 
expiration date. : automatically; the long form prints only If yeu pipe ates 
: N {n response to the short form question. The long 
VERIFY] NOVERIFY | This option fs legal onl pou ney wer. 
HOVE (RIFY) aaa Penge apey One: a form provides information that may help you with an answer 
IMAGE operation. If you Some of the dialogue questions have default values; 
specify the VEfRIFY) these are printed in angle brackets next to the question. 
option, SAVE/RESTORE ; You may select the default value by pressing the LINE FEED 
compares the volume(s) to key or by typing the proper default cesponse. If the LINE 
ensure that the transfer FEED key is pressed In response to a question with no 
was accurate. default value, the question is repeated. 
ST(ATS] SAVE / RESTORE prints 9a There are two valid responses, “Z and “C, In the 
NOST{ATS] summary report at the end 


; SAVE/RESTORE package that can alter the existing operating 
; J status. For example, if you type “Z at any point in the 
specify the /NOST[ATS) dialogue, SAVE/RESTONE returns you to the previous question. 
switch with elther a If you want to abort the run at any time, type “C. after 
function response or a the abort, you will return to the “Cption:" pronpt if you 
single line command. ace running off-line under the control of the INIT.SYS 


of a run, unless you 
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rogeam or te your default Run-Time System prompt If you 

nvoked SAVE/RESTORE on-line with a RUN command. 
SAVE/RESTORE automatically returns to the "SAV/RES 
Function: prompt after the execution of a specified 
function. This occurs when you are elther operating on-line 
or off-line. You may exit From the INIT environment version 
of SAVE/RESTORE to the “Option:" prompt by typing LINE FEED 
oc “Z to the “SAV/RES Function:" prompt. 


SAVE/RESTORE Volunes 


You can perform SAVE/RESTORE operations on two classes 
of volumes: disks and tapes. The SAVE Set, a set of tapes 
or disks created from a SAVE operation, cannot {Include both 
disks and tapes. However, the SAVE Set may include one or 
more volumes of the same class. In other words, a tape 
volume SAVE Set could consist of two MM devices and one NT 
device while one RPO4 and two RKGS disks constitute a legal 
Gisk SAVE Set. SAVE/RESTORE, to repeat, does not allow any 
disk/tape combination SAVE Sets. 


A legal SAVE/RESTORE disk device is any “disk supported 
by ASTS/E. Legal disk devices must meet the following 
requirements: 


1. Must be formatted; that is, contain sector ‘and 
track information. 


2. All disks used by the on-line version of 
SAVE/RESTORE must have a valid RSTS/E file 
Structure; that is, the disk device must be 
formatted and DSKINTed prior to its use. 


3. The first 16 DADERS: on a disk must not contain any 
bad blocks. 


4. RSTS/E output disk can contain no more than 161 bad 
clusters (the ASTS/E limit). 


Magnetic tape is the only valid SAVE/RESTORE tape 
medium; DECtape or cassette are not supported. The 
statecents here define what constitutes a legel tape In the 
SAVE/RESTCRE package. 
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1... The magnetic tape must be long enough to contain 
‘the SAVE Set label and header information, a 


bootstrap, and INIT.SYS which is on the first 
: volume only. : 


2. A bad block will be considered to be the end of the 
tape volume during the SAVE operation. 


3. The default density is the lowest density allowed 
by the drive on which the First volume is mounted. 
Subsequent volumes cannot be written at any other 
density. Therefore, ensure that the density used 

i on the first volume is compatible with e11 other 
tape drives to be used. 


Device Specifications 


Device specifications are required as responses to 
several dialogue questions. These specifications must be in 
the following general format. : 


<device>[: [<id>) } [/<option(s}>) 


where <device> is a two character device type (for disk 
either "Dx" or “Rx" is acceptable) followed by a single 
@igit unit number in the range 0 to 7, The <id> represents 
either a SAVE Set name or a disk pack identification and the 
<options> are selected from the following table. 


Table BKP~4. SAVE/RESTORE Device Specifications 
(page 1 of 2) 


Options 


Description 
SCR [atch} The SCR{ATCH) option is legal only on an 
output volume device specification. TE 
you use the SCR(ATCH] option, 
SAVE/RESTORE by-passes most volume label 
checking. SAVE/RESTORE always checks 
the label to see if an output volune 
contains a SAVE Set written at the 
current density and ensures that it is 
not a volume from-the SAVE Set currently 
being written. it also checks 
destination disks for bad block 
inferraiics. 
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Table BKP~4. SAVE/RESTORE Device Specifications 
{page 2 of 2) 


Options Description 


DEN(SITY):( 680)/ The DEN(SITY) option Is legal only for 
[16ea}} tape. With this option you can specify 
the density at which the tape is to be 
written or read. If SAVE/RESTORE cannot 
read the tape at the specified density, 
it will try to read the tape st the 
other legal density setting. 


Checking the Input Volume 


SAVE/RESTORE checks the input volume prior to any 
ectual data transfer and warns you of any problem that it 
foresees in saving, restoring, or copying the volume. All 
of the error messages that are printed at this point (at 
least concerning the Input volume) are ‘warning messages 
only; you can tecover from them by following appropriate 
Ftocedures. The error messages that result from a problem 


with the {nput volume are listed here and described 
separately below. 


o tt Input disk has only nnt free clusters. 
Mount it anyway <NO>? 


o &Wt This is not the correct volume. 
° 880 This volume has no label. 
° 808 Input disk should be "CLEANed”. 


There must be at least a& many good pack clusters on an 
output ASTS/E disk as there are clusters to be transferred 
from the orlginal input disk. If SAVE/RESTORE determines 
that the input disk has very few clusters that are not 
allocated, {t warns you that you may encounter problems 
copying or restoring the disk. 


FUL Input disk has only nnt free clusters. 
Mount It anyway <NO>? 


Type NO of press the LINE FEEO key to return to the 
previous device prompt. If you type YES, you are 
Instructing SAVE/RESTCRE to procecd wlth the SAVE or TMrce 
oferation. in the case of an IMAGE copy, the program 3iso 
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checks the output volume to see 1£ the transfer can be made. 
No furthee checking takes place in the case of the SAVE 
operation. At this point, you may want to free up space on 
the input disk by deleting unnecessary files. This process 
will inecease your chances of eventually completing a 
successful RESTORE. 


When you specify a Pack ID or a SAVE Set name with the 
Input device specification, SAVE/RESTORE compares the 
specifled name with the name already written on the volume. 
1f the names do not match, the following warning message Is 
printed and the input device prompt is asked again: 


Q4% This is not the correct volume. 


A dismount request follows the above warning message. 
It lists useful information from the volume label but does 
so only if it is a SAVE Set or a RSTS/E File-structured 
disk. 


If the input volume is neither a RSTS/E disk nor a SAVE 
Set, the terminal displays the following warning message and 
the Input device prompt is asked again: 


#43 This volume has no label 


If you remove a disk from a drive without logically 
dismounting it and subsequently attempt to use it as the 
input for a SAVE or IMAGE copy operation, SAVE/RESTORE will 
print the message that follows: 


44% Input disk should be "CLEANed”. 


To perform the cleaning operation simply invoke the 
ONLCLN program {£ running on-line. 


Checking the Output Volume 


SAVE/RESTORE checks the output volume before SAVEIing, 
RESTOREIng, of IMAGE copying a RSTS/E disk. This procedure 
ensures that the SAVE/RESTORE operations will proceed to 
completion with the least chance of. error. The messages 
that SAVE/RESTORE issues, an a result of checking the output 
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volune, pertain to the expiration date, the label, and the 
available data space on the destination device. Some of the 
messages are printed only for your informations; the rest 
warn you of serfous output device problems. The paragraphs 


that follow exhibit the messages, describe why th 
and explain how to respond to hens Zi aie 


When the expiration date of an output volume, labelled 


as a SAVE Set, has passed, SAVE/RESTORE prints this series 
of messages: 


*#* The volume on dev: fs SAVE Set <xxxxxx> 
Density: nnn 

Creation date: day-of-week, dd-mmm-yy 

Expiration date: day-of-week, dd-mmm-yy 


and proceeds to the next dialogue question. If you decide 
not to use the expired date volume, type “Z to return to the 
To Device?" output dialogue question. .- 


Tf the output volume fs labelled as a SAVE Set and its 


expiration date has not passed, the following series of 
messages are printed: 


*** The volume on dev: is SAVE Set <xxxxxx> 
Density: nnn . 

Creation date: day-of-week, dd-mmm-yy 

Explration date: day-of-week, dd-mmm-yy 

Att Ets expfration date has not passed 

Mount it anyway <NO>? 


If you type NO or préss the LINE FEED key In response to the 
mount question, SAVE/RESTORE returns to the previous device 
Prompt. SAVE/RESTORE will proceed to write over the 


existing SAVE Set If you type YES. 1£€ you press the RETURN 
key, the following message appears: wee 


*#*# This is your last chance to prevent the 


*** loss of any data on the output volume. 
Mount it anyway <NO>? 
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SAVE/RESTORE notifies you with the following message 
that the output volume you are using is labelled as a RSTS/E 
disk: 


#**® The volume on dev: is a RASTS disk 
ee* Pack [D 1s <xxxxKx> 

*** Pack will be reinitlalized 

Mount it anyway <NO>? 


If you type NO, or press the LINE FEED key, you direct 
SAVE/RESTORE to return to the previous output prompt. A YES 
response, at this point, Indicates that you wish to use the 
present volume. 


If you RESTORE or IMAGE copy a disk, SAVE/RESTORE 
checks to see whether the total number of clusters on the 
disk minus the number of clusters with known bad blocks fs 
greater than or equal to the number of allocated clusters on 
the original source disk. If SAVE/RESTORE determines that 
there {s not enough space and the transfer cannot be made, 
it prints: 


%&% Too many bad blocks on output disk 
and then returns to the previous device prompt. If, 


however, the program determines that there are very Few free 
blocks (<10%), it prints the following warning: 


aus Only nant of the output disk clusters are available for relocation. 


Fount it snyway <NO>? 


You must decide at this polnt whether the number of 
free clusters 1s large encugh to make possible a successful 
SAVE/RESTORE operation. If you.decide it is not, type NO or 
press LINE FEED to return to the output prompt. Type YES to 
direct SAVE/RESTORE to proceed with the operation if you 
think there are enough Eree clusters available. Whenever 
this warning appears, DIGITAL recommends that, when it Is 
possible, you use another disk for output. Follow this 
procedure since there exists a higher than usual possibility 
that the operation will not succeed. Note that DIGITAL does 
not guarantee that the operation will succeed even {€ this 
message does not appear. 
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SAVE/RESTORE normally transfers each allocated pack 
cluster from the original source disk to the same cluster on 
the output RSTS/E disk. If the output cluster Is found to 
be dad, SAVE/RESTORE will try to relocate the data. If the 
cluster slze of the item being moved is larger than the pack 
Cluster size, there must be enough contiguous free -pack 
clusters on the disk to accommodate the enttre entity 


cluster. If there {fs not SAVE/RESTORE will abort the 
operation. 


If the speciffed output is not a RSTS/E or a SAVE Set 
disk it pcints the new SAVE Set name and proceeds without 
further notice. The program does not check the output 
volune label if you specified the /SCR(ATCH] option, except 
to determine whethec it Is a volume of the SAVE Set that {ts 
currently being created. It always attempts to recover bad 
block Information From a RSTS file structured and SAVE disk. 
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GENERAL COMPARISON OF BACKUP. PROGRAMS 
: Table BKP-5. Comparison of Backup Programs 
SAVE/ RMSBCK/ 
BACKUP RESTORE RMSRST 


Copy Large Filles Yes (5) 


Maintain Position 
of Placed Filles Yes(2) No 
Selective Backup ae 4 


and Restore he Yes Yes 
Backup and 

Restore Public 

Structure On-line Yes(3) Yes 
Backup and 

Restore Private 

Structure On-line Yes Yes(3) Yes 
Bad Blocks on the 

Output Medlum No 
Creates Bootable 
Volumes Yes No . No 


Compensates for 


Runs Of f-lIne Yes No No 


Restores Files to 
Different 
Accounts then 
Backed up From 
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(1) SAVE/RESTORE malntains the position of placed Elles TRANSFERRING RMS RELATIVE AND INDEXED FILES TO OTHER NON- 
upon: recovery as long as bad blocks on the output RATING SYSTEMS 
disk do not interfere with the placement of the a RSTS/ B-O8E 
first cluster of the file. “y, File or flles fit on one magtape 


(2) PIP maintains the position of a file {ff the user 


a. Use RMSBCK on the RSTS/E system. 
specifies that the output €lle ts to be positioned. : 


I£ PIP cannot position a £flie at the user specified b. Use RMSRST on the other system. 

block, it will attempt to create the file between 

the specified block and the end of the disk. If it 2. File requires more than one magtape 

still cannot find a space to create the fille, it : 

will start at the beginning of the disk and attempt a. Use RMSCNV to do 4 disk to disk conversion to 
to find space for the Elle. If the Elle is located : an RMS Sequential file. 

at a lower numbered disk block than requested, it is 

not marked in the directory as a placed File. I€ {ft . b. Use PIP to transfer the sequential File to ANSI 
cannot be created at all, the “?No room for user on magtape with no switches. 


device" error is generated. 


; i ce. On the other system 
(3) PIP does not store project,programmer numbers in 


ANSI magtape labels. Therefore, it is difficult to 1. Relative file - use AMSDEF and RMSCNV 
recover fEiles to multiple accounts from ANSI : 
formatted magtapes. DOS magtape labels do store . 2. Indexed Eile - use RMSDEF and RMSIFL 
project,programmer numbers, but do not store RMS-1] 
attcibutes, DOS format also does not support 3. Another possible consideration, for example: on 
multi-volume magtape flles and therefore cannot : , 
support large Elles that do not fit on one volume. . a. If you have an 86,@80-biock indexed file 
. , (409,000 82-byte records), the back-up (RMSBCK) 
(4) Bad blocks on the output disk cause contiguous Filles copy of the Elle requires at least two magnetic 
to be made non-contiguous. ‘ tape volumes. 
(S) RMSBCK can copy large files as long as they can fit b. However, {if you convert (RMSCNV) the file to 
on the current output volume, There is no tape with 4096-character blocks, you need only 
multi-volume capability sllowing files to cross a one 2460-foot tape volume. 


volume boundary. : : 
" ce. You can then rcestore the Eile quickly with 
RMSIFL. 
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User utility Programs 


INTRODUCTION 
As RSTS/E users you know the wide range of services 


offered by the CUSPs supplied with a RSTS/E system. 
Some of these services include: 


a File manipulation 

o File transfer 

9 Directory listing 

e Batch processing 

o File spooling 

-RSTS/E V7.@ includes new and revised utilities 
which provide you with greater fiextbility in handling 
your day to day and long term needs. 


In this module you will learn these new and revised 
non-privileged utllity programs. 
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TIT PROGRAM 
*°o Transfers flies between 


Disk and TUSB 

Disk and floppy 

RSTS/E disk and RTL disk 
RSTS/E disk and RT11 DECtape 


o Transfers Eiles from a DOS disk to a RSTS/F disk 
' ° Lists directory of a TU58 and floppy 
fr) Lists directory of a DOS disk 


Additional FIT Documentation 


TUS8 DECtape If and floppy disk Elles are maintained in 
the RT11 directory structure format, Thus, DeCtape II and 


floppy disks are. directly transferrable between RSTS/E and 
RT11 systems. 


_ To Invoke the FIT program, you must be logged into the 
system and type the following command: ; 


RUN SFIT 


If FIT 1s successfully invoked, it prints an identifying 
message followed by a FIT> prompt. The prompt indicates 
that FIT 1s prepared to accept a command line. To cause FIT 
to print a help text file, type the /HE switch in response 
to the prompt. To exit from FIT, type CTRL/Z in response to 
the prompt, for example: 


FIT>*2Z 
Ready 
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Transfecring Files with FIT 


To transfer a file with FIT, type a command line of the 
following form in response to the FIT prompt: 


FIT> (output [ /sw) =) input (/sw] 
where output and Input are file specifications and /sw is an 


optional switch that specifies the structure of the device 
on which the file resides (RSTS/E, RT11, or DOS). 


The input and output file specifications have the following 


forms: 


devi tproj prog] name .ext< prot> 


where: 7 

dev: fs a device specification. If none ts 
specifled, the defavlt {s the public 
Structure. The output device must not be a 
pOS disk. The input device can be a RSTS/E, 
RT1l1, or DOS disk; or RT1L1L TUSG DECtape? or 
RT11 TUS DECtape Il; or RT11 floppy disk with 
RT11 Elle structure. 

projeprog , is a project-programmer number. If none is 
specified, the default is your current 
account. FIT ignores the project-programmer 
number 1£ the device has an RT11 file 
structure. 


name.ext is a fllename and extension. If none is 
specified for output, FIT uses the Input 


Ellename and extension, An input filename 


must be specified. 


<prot> fs a protection code. If none is specified on 
output, FIT assigns your current default 
protection code. FIT ignores any input file 
protection code specification. 
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ene legal Input device specifications for a FIT file 
cransfec are as follows: 


ASTS/E disk . 

floppy disk (RT11 format) 

Tu58 DECtape IL (RT11 format) 

RT1L disk (with pack clustersize = 1) or TUS6 DECtape 
(RT11 format) 

pos disk 


The legal output device specifications (except for pos 
input) for a FIT flle transfer are as follows: 


RSTS/E disk 

floppy disk (AT11 format) 

TU56 DECtape Ii (RT11 format} 

RTil disk (with pack clustersize = 1) or TUSG DECtape 
(RT11 format) 

line printer, keyboard, etc. 

DECtape (RSTS/E format) 


If the input device is a DOS disk, the legal output devices 
are as follows: 


RSTS/E disk or DECtape 
line printer, keyboard 


the switch specification /sw can be one of the following: 
/RTLI The File Is on an RTLL file structured device 


/DOS The file is on a DOS format disk (legal only for an 
input flle specification) 


/RSTS The file ts on a RSTS/E disk or device. This 
switch is illegal with floppy disk and Tus8 
DECtape II. ” 


These switches can be abbreviated to the first two letters 
(foc example, /RT, /DO, and /RS). 
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If you do not specify a switch on the input specificatton, 
FIT attempts to determine the file structure of the Input 
Elle device. ff the Input device does not contain a valid 
RSTS/E, RTIL, of DOS flle structure, FIT prints the 
following error! 


PINPUT DEVICE NOT FILE STRUCTURED 


If the input device is a RSTS/E format DECtape, FIT prints 
the following error: 


PILLEGAL INPUT DEVICE 


y i 
If the specified Elle does not exist on the device, FIT 
prints the following error: 


7CAN'T FIND FILE OR ACCOUNT : 

Tf you do not specify a switch on the output speci£ication, 
FIT assumes # default file structure based on the type of 
device. That is, 1£ the device is TUS® DECtape II or floppy 
disk, FIT assumes the ATII file structure; 1£ the device is 
disk or TUSS DECtape, FIT assumes the ASTS/E file structure. 


If FIT determines that the output device should have an RT11 
file structure, the following errors are possible: . 


2NO RTLL STRUCTURE ON OUTPUT 


The output device does not contain a valid RTIL file 
structure. Check that the right device was specified. 
An RTI] structure must already exist on the output 
device before files can‘be transferred to it. The {2E 
aha can be used to create an RT11 structure on the 
device. 
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pees toaly OVERFLOW 


the output device has no space for directory entries. 

However, {it may be possible for you to use the /S9° 
switeh to free more space for directory. If this is not 

successful, you must delete some of the files on the 

device before more can be added. Note that 1£ you 
t{ntend toe have many small filles on the device, you 
should vse the /N guitch to allocate more than the 

default number of directory segments when the device is 
zeroed. : 


DEVICE FULL 


The output device has no free space for the tlle 
transfer. It may be possible for you to use the /SQ 
switch to create enough contiguous free space for the 
additional Elles. ‘If this 1s not successful, you will 
have to delete enough files from the output device to 
add the files from the input device. 7 


These errors are generated prior to the transfer of any data 
to the RT11I structured device. If an error {s encountered 
during a transfer, a RSTS/E error is reported and the 
transfer Is aborted. Because the directory entry for the 
RTIL Elle is not £inalized unttl the transfec is complete, 
an error during transfer causes the space reserved for the 
file to be freed. i 


If an error is encountered during the open or transfer phase 
of a RSTS/E Elle operation, the appropriate ASTS/E ercor is 
generated and the transfer is aborted. 


Maintaining AT11 Pormat 


In addition to transferring. files: te and from an ATI1 
directory structured device, FIT can perform the following 
operations: 


le You can use the /2ZE switch to zero and Initialize a 
device as an ATI] device. This operation creates an 
RTIL directory structure on the device and must be 
perforned prior to transferring files to and fron 
the device. 
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2. You can use the /L ) 
Y svwi 
listing of the rT11 preyebeas ne eore Pareeeery 


3. You can use th 
La eg e /DE switch to delete a file on an 


4. You can use th 
e /SQ switch to compress 
aibaet | a the device and ailee sore tlice ye 
hie 7" at device. This operation is useful if 
vallable space on the device is fragmented 


Fr 
ile Deletion on an RATI1 Format Device -- To delete a file 


on an RTIL directory structured 
ad 
command format in response to the Oe care pene 


Fifddev: Fllename.ext/DE 
where dev: Identifies : 
the devi 
the file to be deleted 
aie ed. I£ the specified 
Srince ae poked or if the Fille nee ae ies wae 
eM Pea message. If an error is encountered by FIT 
es the device, a RSTS/E error 18 reported oo 


QT 
11 Device Switches .-~ you can perform zeroing, 


compressing, and 1lstin 
Se Cee g operations on ATI11 directories’b 
Sets ollowing command format in response to the 


PitT>dev :/swl /sw] (/sw] 


ce de t fn icate 
whe Vv d st 
/ he device on which the operation is to 


es th 
you specify can be one or more of the flicdnan pee 


/7Eim 

aa ed device and bufld an ATI directory 
oe ates IE sm is specified, m extra words 
aS ated information for each file are 
apd - e minimal RTIL directory structure. 
words, by derauite ca ne digesters reictace: 
These words are ‘used to fore the run tine 
system name and flie strelburce. eee 
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ce and fllename.ext specifies” 


7Nrn 


Note that RTL systeas currently ignore these 
extra directory entries. However, 1 futece 
releases of ATI1 attach significance to these 
words, a specification off/ZE:9 may be required 
for ATI1 files that are read by RT11 systens. 
FIT currently ignores extra directory 
information unless there are 13 extra words 
(this may change in future releases). 
Therefore, you should only specify values of 8 
or 13 in the /ZE switch. 


‘Used with the /ZE switch to cause n directory 
segments on the inittalized device. Each 
segment consists of two Sl2-byte blocks. The 
value of n must be in the range of 1 to 31 and 
determines the size of the directory on the 
device (and, therefore, the number of Elles 
that can be stored on the device). The number 
of filles that can fit on 2 device is 
determined by the following formula: i 


n* INT (587/m+7) 
where n ig the number of directory segments 


and m is the number of extra words for each 
directory entry (that fs, /N:n and /ZE:m, 


_ respectively). 


Note that you may have to compress the device 
with the /SQ switch before the maximum number 
of files is reached. 


If you do not specify n, FIT applies defaults 
based on the device type. These defaults are 
Indicated in the following table. The table 
also lists the maximum number of files allowed 
on a particular device corresponding to your 
specification in /ZE:n. 
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TUSS8 DECtape II 
Floppy disk 


RKGS disk 
RKO6 disk 


/LI or /DI 


/RTLI 


/8Q 


— RSTS/E Sas uptace 
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Table UUP-1. Defaults by Device Type 


Default 
number of 
Directory segments 


Max. 
number of | 
files /ZE:@ 


Max. 
number of 
flles /2E:13 


104 
416 


List the directory of the device. The 
information listed Includes filenames, 
extensions, file size, protection codes, dates 
of creation, and position on the device. [f€ 
the device has 13 extra words for each 
directory entry (/2E:13, the defavlt value), 
the run-time system namé and File attributes 
are also printed. Those sections of the 
device which are free space are marked 
<UNUSED> in the listing. 


Used with the /LI or /DI switches. /RTUL 
indicates that the device must have RT11 
directory ‘structure. That Is, !£ this switch 
is not present and the device is a DOS disk, 
a directory of the DOS disk {fs listed.’ IE 
this switch fs present and the device is a DOS 
disk, an error is returned. 


.Compress (squeeze) the device. This switch 


allows you to compress the files that are 
currently on the output device and make room 
for files that are to be transferred. The 
space on AT11 devices that {s allocated to the 
directory or files can become fragmented. If 
this Is the case, an attempt to add another 
Elle to the device can result in a ?DIRECTORY 
OVERFLOW or ?DEVICE FULL error. You can use 
the /SQ switch to compress the contents of the 
device and provide enough room for the 
additional files. . 


UUP-1a COMPANY TONFICENTIAS 


BITTE Tet SRORTE 


Tees User wtsasty Pregrars 


Nete that because cf the manner in which RTIL 
directory entries are made, you may need to 
compress the device to use the directory space 
even if €iles- are added contigucusly without 


deletions. 


fated to 
All of these switches can be abbrev 
one letter (for example, ft, ¢W, /L, /0,. JR. 
and /S). 


pos Disk Directory Listings 


To list the directory ef a DOS disk, enter the following 
command format in response to the FIT prompt: 


FIT>dev:(/DO(S}]/LIT) 


The 
ev: is the device designator of the DOS disk. 
ee or /DI can be used In place of es f/LI. ae ne 
/p0s switch {ts omitted, FIT lists the d Shelve Sie i 
device whether it is DOS or RTL directory struc u a one 
the /D0S switch {is present, an ecror is returne 

device {is net a DOS disk. 


Includes the 

The listing generated by this operation 
following sare cast lees account numbers (UICS), Snaiacise 
extensions, flle lengths, pretection codes, one nee 
creation, the First and last block numbers of the Elies, u 


whether or not the file is contiguous. 
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RMSIFL PROGRAM 


° Provides é 
pond fastest population of multi-key Indexed 


Input file can have any RMS file organization 


° Output £1 
penile le must be Previously created and must be 


Additional RMSIFL Documentation 
Purpose 


The RMSIFL utility 
Provides the fastest 
Satie of populating an empty RMS-1] Indexed ie Oetne 
y can read records from any type of AMS-11 file and 


load them {nto an Index 
ed £ 
Created. However, RMSIFL does nee ca rea ataged 


Although RMSCNY may compete with this utility when 


foster site Ac eeu ote aoe RMSIFL is definitely 
; ulti-ke 
you must use RMSCNY {if the output Miletid oo ey ee 


Effect 


-RMSIFL reads records from a 
niin 
into an output Indexed File in a series ae loads them 
1. 


Hig utility examines the command 
t for syntax and/or other errors. When {ft has a 


valid command string, RMSIFL determines !f the input 


flle must be sorted { 
output flle's Primary Key. ea a ie 


string, rejecting 


RMSTFL 
bhace ices the sort phase {phase 2) and skips 


° You {Included the Inflle Switch Noso. 
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o The key of reference specified for an Indexed 
{Input Eile is equal to or contains the output 
primary Key, based on position only. Nonstring 
key types must match exactly, in starting 
position and length. String keys must start in 
the same position, but the Primary Key can be 
the same length as or shorter than the Input key 
of reference. 


You specify key of reference with the KR Inflle 
Switch. 


Example The ten-byte string input Alternate Key 
2 starts at byte @ and is specified as 
the key of reference. The eight-byte 
string output Primary Key starts at 
byte @. AMSIFL does not sort. 


Example The ten-byte string Input Primary Key 
starts at byte 90. The elght-byte 
string output Primary Key starts at 
byte 3. AMSIFL sorts the input file. 


Example The three-byte packed decimal input 
Alternate Key 1 starts at byte 43 and 
{s specified as the key of reference. 
The three-byte packed decimal output 
Primary Key starts at byte 42. RMSIFL 
sorts the input File. 


RMSIFL notifies you that it has started 
processing by printing the following message: 


PRIMARY KEY: 
2. RMSIFL reads the input file in Sequential Access 


Mode, depending on the erganization of the Input 
files 
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INPUT FILE 
ORGANIZATION PROCESSING 


SEQUENTIAL AMSIFL reads the records in the 


Sequential Access Mode 
st 
the first record In een sans 


RELATIVE RMSIFL reads the recards in the 


Sequential Access Mode 
fecord cell 1. Pitre arn aee 


INDEXED RAMSIFL reads the records i{n the 
Sequential Access Mode, follewing the 
key of reference specified in the 


command strin the 
de caulels 9 [ Primary Key is 


RMSIFL passes each record to m 
odules extracted 
the SORT-11 utility. These modulas order the Gen 


cecords by ascendin 
pehe cared hea value in the Primary Key field 


At the beginning cf this 
phase, RMSIFL al 
ee Rig ates for three sort work files, Rien GEER 
e size of the 1.5 times the Input Eile. 


Note 


Performance in this phase depends 


entirely on the SORT-11 utility. See the 


Terooe oat Reference Manual for 
Information on the Space required fo 
temporary sort files and Guldance on the. 
factors affecting sort performance. 


RMSIFL notes this ph 
Ly ert phase by Printing the following 


SORT ‘HAS STARTED 
SORT MERGE PHASE HAS FINISHED 
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RMSIFL loads the ordered input records Into the 
output file, constructing Level @ of the Primacy 
{index one bucket at 2 time. 


The manner in which RMSIFL reads Input records 
depends on whether the Input file was sorted in 


phase 2: 


° If RMSIFL sorted the input file, the utility 
accepts the input records one at a time from the 
sort modules. This technique avoids the need 
for a temporary file containing the input 
records sorted in output Primary Key order. 


° If RMSIFL did not sort the input file, the 
utility reads the records from the input File. 


RMSIFL examines each record to ensure that it is 
compatible with the output file: 


° If the record is not compatible, RMSIFL 
processes it as an exce tion record according to 
the switch you have speciffed in the command 
string. See the discussion of the ER: 


(filespec] and NOER Infile2 switches for the 
causes of exception records and their handling., 


° If the record is compatible, RMSIFL inserts it 
into a Level @ bucket being built in memory. 


As the utility places each record, the utility 
extracts the values for each of the Alternate Keys 
defined for the file, if any: 


a. RMSIFL converts nonstring key data types into a 
stringlike representation for sorting only. 


b. RMSIFL combines the Alternate Key value with the 
Record's File Address (RFA) of the user data 
record that supplied the key value. RFAS are 
six bytes long. The utility then appends a byte 
with the key number and the converted version of 
the key value. 
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ae Elyed-Length Alternate Key records are 
w en into a separate temporary flie 

IFL@. T™P, RMSIFL creates this Eine with sa 
initial allocation of 102 blocks and a Default 
Extension Quantity of 188 blocks. You can 


calculate the final siz : 
follows: aed IFL@.TMP (ALQ) as 


ALQ = NDRF * NAK * (LKS +7 + PAD) 


where NDRF ts the number of user data records in 
the input File, 


NAK Is the number of Alternate Keys defi 
the output File ys defined for 


LRS is the size of the longest Alternate Key 


defined for the output file {and shown b 
RMSDSP), in bytes, and” ¥ 


PAD {s the number of null bytes added to word 
align the record: :: 


PAD = @ Lf LKS 1s an even number 
PAD = 1 If LKS 19 an odd number 


Poa maker to round ALQ to the nearest multiple of 


During this process, the utility assembles the 
index levels of the Primary index as well. 
RMSIFL puts an index record inte a Level 1 
bucket for each Level @ bucket ft writes to the 
flle. When 1t writes a Level 1 bucket to the 
file, the utility inserts an index record into 
the Level 2 bucket, and so on, up to and 
including the Root. 
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AMSIFL sorts the Alternate Key temporary Eile into 
order by key number and ascending key value. 


At the beginning of this phase, RMSIFL allocates the 
disk space for sort work files, each of which is 1.5 
times the size of IFL9.TMP. 


The utility notes this phase by printing the 
following messages: 


ALTERNATE KEY 
SORT HAS STARTED 
SORT MERGE PHASE HAS FINISHED 


RMSIFL builds the Alternate indexes one at a time, 
from Level @ up to the Root, using the sorted 
temporary file for input. 


The utility notes the construction of each alternate 
index by printing the following message: . 


ALTERNATE KEY(s) nnn 
where nnn starts with 1. 


RMSIFL prints the fellowing messages when the output 
file is completely built, then terminates the 
processing of the current command string. 


NUMBER OF INPUT RECORDS: nnonnn 
NUMBER OF OUTPUT RECORDS: nnnnn 
NUMBER OF EXCEPTION RECORDS: nnannon 


Note 


RMSIFL extends the output file 1€ ft 
Cannot contain the input records and the 


Index(es). The utility minimizes this 
overhead by extending the file a_ set 
quantity each time It requires space. 
This quantity Is the Integral multiple of 
a bucketsize greater than 56, 
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Call and Termination 


Using the cct command — 


IFL [command string} 


If you tnclude a command string, 


execute ft and th the utility attempts to 


en returns control to your default run-tim 
-~time 


If you do not 
specify a 
control and prints the ae a string, RMSIFL assumes 


IFL> 


You may enter a command String oF CTRL/2 to terminate the 


utility. When pA 
prints the prompt SIFL has executed a Command string, it 


Using the RUN command - 


RUN SRMSIFL 


. 
* 


The utility assumes control and prints the 
IFL> 


Prompts: 


You may type a comn : 
mand $ 
utility. When AMSIFL Reb Or CTRL/Z to terminate the 


reprints the prompt a8 executed a command String, it 


Command String 


General Ferm - 


gut file(/switch)..J=infilet/sutten) ..1 


the Input fFlle. wild card 


char 
acters are not Permitted tn any fleld of th 
e 


specification, 
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a<SIPL chesks for the following conditions in the output 
ste. Tf they are not met, the utility prints the indicated 
errse message and terminates execution of the command 


string. 


° The output fille must exist before you run the 
utility, otherwise, RMSIFL prints the message: 


“PEF L--FILE NOT FOUND - filespec 


° The output file must be empty except for the 
' prologue written when the Elle was created. 
Otherwise, RMSIFL prints the message: 


PLEL--INDEX OUTPUT FILE NOT EMPTY 


0 The output fille must be an RMS-11 Indexed file. 
i Otherwise, RMSIFL prints the message: 


VIFL--OUTPUT FILE MUST BE AN INDEX FILE 


o The output Eile must not have a bucket size greater 
than f€five blocks. Otherwise, AMSIFL prints the 
message: J 


VIE L--THERE IS NOT ENOUGH IFL MEMORY FOR THE CURRENT 
COMMAND LINE 


° The output fle cannot have more than ten keys 
defined. Otherwise, RMSIFL prints the message: 


7IFL--TOO MANY KEYS ~ filespec 


infile is the Ellespec of the input file that Is the source 
of records to be written to the output file. Wild 
card characters cannot appear In any field of the 
Ellespec. ‘ 


You can specify only one Input file, but {t can have 
any RMS-11 file organization. RMSIFL does mot 
affect the input flle in any way. 


- 
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The utility opens the input file access read, allow 
No-write, Therefore, no writing. task can access the 


Input Elle while AMSTEL fs operating. 


The {Input flie cannot have more 


than ten keys 


defined. Otherwise, RMSIFL Prints the messager 


?IFL--TOO MANY KEYS ~ filespec 


You cannot use a back-up file produced by RMSBCK as 
input. RMSIFL terminates with the following error 


message: 


?IFL--OPEN ERAOR ON FILE - fllespec 


?7IFL--FATAL AMS ERROR STS = ~@1424, STV = g8¢00 


svitch may be one of the codes shown tn the table below and 
described on the following pages. 


Note 


word “HELP” ofr a question mark 
RMSIFL responds with a HELP message. 


RMSIFL Utility Switches 


Type Switch Description 


String ? or HELP Print HELP message. 


Global /ID Identi€y current version 


Outfile /EA Write exception records 


on terminal. 


ER: Ellespec Write exception records 
into specifled File. 


/to Honor £111 numbers 


A command string may also consist of the 


Default Process 
No help. 
No {d. 


Same. 


Write exception 
tecords on terminal. 


Fill buckets. 
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i immediately Write except 
NOE ie inser eecera is records on terminal. 
incompatible. 
s to output Handle input as 
en bee wees : exception record if 
ene different lengths. 
/TR Truncate Input records to Handle input as 


if 
ength. exception record 
ie aaa different lengths. 
Create and use sort 
work files on 
SYSDEV. 


: t ices for 
DE:dvn{tdvn Reassign dev 
MER oeet sort work Elles. 


/¥Rin Key of reference number. Primary Key (n=0).- 


; ding. Sort {input Elle 
/NOSO Bnet APES Perera cea before loading. 


Global Switches - 


o ID causes RMSIFL to print the version number of the 
utility that is operating in the form: ‘ 


IFL ~- VERSION 1.86nn 
where nn is the patch level of the utility. 


This switch may appear alone on a command string. 


Outfile Switches 


P cessing 1E 

o ER: (£ilespec] directs RMSIFL to continue pro 

‘Lt encounters a record In the input file that at 
be weftten into the output file. Exception recor 
can exist for one of the following reasons: 


ftch and the 

° You specifled the NOSO Inflle Sw t 

utilley feund a record that was net in cone 
collating order by Primary Key value. The erro 
message Is: 


SFL--EXCEPTION RECORD: RECORD OUT OF SEQUENCE 
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6 You did not allow duplicates in at least one key 


of the output Efle, but an input record contains - 


a dupileate valu 
scesae le, © Anettae key value. The error 


IFL--EXCEPTION RECORD: DUPL 
RL UGED ICATE KEY WHERE NOT 


e An Input record is not long enouwh to contain 


the Primary Ke t P 
messige ree y of the output file. The error 


IFL--EXCEPTION RECORD: RECOR 
SREAEY eee D TOO SHORT FOR 


© An input record is teo ion i 
g to fit in a bucket 
of the cutput fille. The error message is: 


IFL--EXCEPTION RECORD: REC 
i at CORD TOO LONG FOR 


° An Input recerd is not com 
patible with th 
output file's fixed-length record format and ne 


have not specified the PD and 
The error message is: Age RS ame tees 


IFL~-EXCEPTION RECORD: REC . : 
eeeen ORD DOESN'T FIT FIXED 


o An Input record is longer than th 
E @ output fille’ 
varlable-length Maximum Record Size ane you hee 


He specified the TR switch, The error message 


. 


IFL--EXCEPTION RECORD: RECOR 
MAXIMUM RECORD SIZE oO fern fovea 


IE€ RMSIFL encounters an exception whi 
processing the Alternate indev les). ha ae ate 
data record in the Primacy Level @.. The utility 
dees not remove the record from the Eile. The 
record may be compressed during later use of the 
Indexed Elle. 
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You can add corrected exception recerds te the 
cutput file sfter RMSIFL terminates with elther an 
application pregcam or RMSCNV {possibly using your 
terminal as the input device). 


If you de not specify an argument (fllespecl, AMSIFL 
prints the apprepriate errer message, then the 
exception cecord on your terminal. 


I€ you specify a nondisk file oc a terminal, the 
utility creates it as an RMS-11 Sequential flle with 
variable length recerds when the first exception 
record is encountered. Then, RAMSIFL writes beth the 
error message and the exception recerd into the 
file. RMSIFL uses this procedure for every 
exception record until it finishes processing. 


1€ you specify a disk Elle, the utility creates it 

as an RMS-11 Sequential fille with VFC records when 

the first exception record Is encountered. Then 

RMSIFL weites the exception cecerd into the vaciable 

Peccien of the cecord and a four-byte excepticn code 
nto the £ixed control area. The codes are: 


Code Meaning 


eel Record is cut of Primary Key sequence. 

902 Record contains an illegal duplicate value. 

683 Recerd is teo short to contain output 
Primary Key. 

004 Record {is too leng to fit in output bucket. 

aa5 Record is not correct size for output Elxed 
length record, 

984 Record is too leng for output Maximum 


Record Size. 
Alse see the NOER switch. 
Default If you do not include the ER switch, RMSIFL 


prints an appropriate error message Firste 
then the exception recerd on your terminal. 


JIP-73 SOM PENY TONFILENT IAL 
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ASTS/E SaS uplace 
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o LO directs RMSIFL to write records into buckets 


according to the £111 numbers established when 
the file was created. 


Default If you do not Include the LO ewitch, 
RMSIFL Inserts es many records as 
possible into each bucket. 


o WOER(:S] directs RMSIFL to print an error message, 
delete the output flle, and terminate processing 
immediately {££ it encounters an input record that 
cannot be written inte the output file; see the 


ER:([f£ilespec}] switch for reasons and error 
messages. : 


RMSIFL deletes the output flle unless you specify the 
SAVE argument (:S) {in the NOER switch. Termination at 
this point leaves the output file Incomplete: it is not 


& valid Eile organization and cannot be used for any 
RMS-11 purpose. 


Default If you do mot include the NOER switch, 
RMSIFL respends according to the version 
of the ER switch you used. 


o PD(:(#}x}) directs RAMSIFL to pad records read: from the 
Input file to the output file's record length 
before writing them to the output Eile. padding 
character {s specified as follows: 


Switch Character 

PD NULL 

PD:x x Is ASCIE A-Z, 8-9, or special 
character except #, ?, and 4 

PD: Ix x is octal number 486-377 (40 for 
SPACE, 43 for §, 77 for ?, and 189 
for @) 


You use. the PD switch only when the output File 
specifies Elxed-length records. . 


Default If you do not Include the PD switch, and 
the input records are shorter than the 
output Elle's records, RMSIFL treats then 
as exception records. 


See the ER and NOER switches. 


VuP-ls Ttepawr TMP ret oes 


ds vead from the 
rectsS RMSIFL to truncate recot : 
ma ae tlle to the cutput file's Waximun Record 
- Size before writing them to the ovtput Flle. Tre 
trailing bytes of the records are truncated. 


L {tch, and 

efault If wu do not include the TR sw 

° che input records are lenger than the 
input Eile's rcecord RMSIFL treats them 
as excepticn records. 


See the ER and NOER Switches. 


i 
Inflle Switches 


sdvn{:dvn{:})] directs RMSIFL to reassign the 

: Derdvn teen vate tt allocstes the three sort work 
files. Yeu can specify Erom one te three disk 
devices with the switch, where dvn is a physical 

device name and number or a logical name up to 

six alphanumeric characters. You separate device 

names by. a colon (:)3 the final colon is 
optional. 


If you include the DE switch in the command a 


RMSIFL reassigns all three sort work files: 


tility 
° If you specify one device name, the ut 
Ei xeeigne the three work files to that device. | 


tility 

° If you specify two device names, the u 

vedaslans one work file to the First device and 
two work files to the second. 


° If you specify three device names, the utility 
reassigns one work file to each device. 
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OSStsaLr RSTS‘E Sas uptacte 


User Usility Programe 


For cptinum performance, you should assign each sort 

work Eile to a different device, Wowever, If you have 

ently two devices available, assign the first and third 

Peps to one device and the second fille to the other 
evice. 


Example /DE: DMG: DM 1: 42 
Example /DE: DMO: D4 1: DMO 
Default RSMIFL allocates the sort work filles on SY: 


o KA:n directs RMSIFL to read an input Indexed file 
according to the key specified by n, where n is @ 
for the Primary Key, i for the First Alternate 
Key; and so on. 


The KA switch can eliminate the need for sorting the 
fnput Elle; see the "Effect" section. 


Tf you use the KA switch with a Non-Indexed fille, RMSIFL 
terminates with the following message: : 


7LEL--/KR NOT ALLOWED FOR SEQUENTIAL OR RELATIVE FILE 


Default If you do not Include the KR switch, and the 
input file is Indexed, RMSIFL reads the file 
via the Primary index. 


o NOSO directs RMSIFL to bypass its sort phase of 

precesstng because you have already sorted the 

nput file. I€ the Input file fs not in order by 

ascending value of the output file's primary Key, 

RMSIFL's response depends on whether you have 

inchwed the NOER switch or a version of the ER 
switch. 


Default If you do not Include the NOSO switch, 
RMSIFL sorts all records from the input 
file into the proper order. See the 
"Effect" section. : 
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oorege 
sake 


Cauticns 
Cauticn? 


e 


ert £ Sat TRPLATE 


User Liab .ty Pregracs 


RMSIFL Igneres the fixed control area of VEC recerds 
{n both the Input and output files. 


When both the Input and output files have 
fixed-length records, RMSIFL requires either the TR 
er PO switch ff the fixed recerd lengths are act 
equal. Tf neither switch is specified, the utility 
terminates with the errer message: 


7IFL--INPUT AND OUTPUT RECORD SIZES DO NOT 
CORRESPOND. 


When the input file centains variable-length recerds 
and the output file contains fixed-length records, 
RMSIFL requires both the TR and PD switches. If 
both are not specified, the utility terminates with 
the error message: 


7IFL-~SWITCH /TR OR /PD OR BOTH ARE NEEDED FOR THIS RECORD 
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User utility Prograns 


e Example 


RUS SRMSTIFL 
TFL? 
RMS-11 INDEXED FILE LOAD UTILITY 
tae ip Uno t eee e 


GLOSAL OPTIONS: 


7 OR HELP TIPE THIS MESSAGE 

710 TOENTIFY CURRENT YERSTON ARD PATCH LEVEL 
OUTFILE OPTIONS: : 7 

FERESFILESPEC) WRITE EXCEPTION RECORDS TO TERMINAL 


{OR TO FILESPECY 
/Lo HONOR FILL NUMBERS 
ANOEAL:$) STOP PROCESSING IF INPUT RECORD IS 
INCOMPATIBLE AWD DELETE THE OUTPUT FILE 
(IF :S £8 SPECIFIED SAVE OUTPUT FILE) 
PoC: (#2) PAO INPUT RECORDS TO OUTFILE RECORD LENGTH 
7A TAUNCATE INPUT RECORDS TO OUTFILE RECORD LENCTS 


INFILE OPTIONS: 
/DE: a OYN(:DVNC1 JT) REASSIGN OLVICES FOR SORT WORK FILES 
PERS NN KET-OF-REFERERCE NUMBER 
7#0S0 DO NOT SORT INPUT BEFORE LOADING 
IFLOWES. TOX2O4LT. MAS 


KEY CHECK 

PRIMARY KET: 
SORT HAS STARTED 
SORT MERGE PHASE HAS FINISHED 
HUMBER OF INPUT RECORDS: 1 
NUMBER OF OUTPUT RECORDS: 1 
WUMBER OF EXCEPTION RECORDS: O 

IFL>*E 


Ready 


Pigure UUP-1. RMSIFL 
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RASCHVY PROGRAM 


9° 


Uses deferred write feature of RMS 


Allows a switch to specify mass insert feature of 
RMS 


Example 


RUN $RMSCNY 
CNYDONLY1.MAS/MA/FO: IDX=ONLY.MAS 


CNY>7z 
?Task exit status: SEVERE ERROR 


Ready 


Figure UUP-2, RHSCNV 
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RMSOEF PROGRAM . 


© 


° 


° 


Allews specification of new RMS key data types 
Allows placement of RMS files 


Example 
Fun StKSOTE 
30 YOO WANT TO CEMEAATE A COMMAND FILE FOR PuToRE wSEtNarTTES 
Ceres Ftet Seaciricaysow Fos CommaND FILELORLT,CHO 
09 TOY VANT TO CACATE THE FILE Too WILL SE CESCAIOLNCCRO}TYES 
HBTIR FILE SPECIFICATION: OML TS. mAs 
If Tae FILE CLRTAOT CLTSTS, OO TOU MANT TO S¥PERSEDE EttnarTTES 
EATCO FILE GACARtLATIONCSEO) ton 
CETEE RELOES CORRS TCCAR TET 
CATED MARTI PCCOND S1TEL62 
BO TU CANT CAPRTECE PETURR CONTROLITES} THO * 
BO 13d Vast SosThaw CeamacreR COMTROLCRODT 


It'S TI*E TO OCTIRE THE PRswART RET 
CHTCR CATA THPCESTRED 


COTER PISTTISW OF RET: 10 
CATED SEEL OF RETES 


COTER waMe OF CLT (WORTD: 
WILE PRE SLL D2 DUPLICATE KOTS(HODITES 


BO Td WiaT 19 CEFENE “ORE CETSEROIT 

bo YU VAST TO OfFERe eneAzeNol? 

00 TY HANT PLACENERT ComTROL uo} ?TEs 

CaTe® LOCETIOT: $00 

LOTEP IVETEAL ALLOCATION F¥ BLOCRS{ 91; 100 
Ceree escent sreetrice 

QVCO MPAUEE Cuteastow QuaaTtTe tm eLoces (308 
8) 129 verT A CONTICUIUS FILECWONTTES 

THESE QVESTIONS BPC FI8 THE PRLSHAY CET: 


mCUET S120 89 8 Steces. 
FILL RsSEN P30 Data BUCKET SESS 90 


TALL WUNSER FOR teER BICETTSOII TO 


tate 


* CNC CL IRTEMSELEC DL Zy 


Caree weatecesce coonteat: 08 . 
Tse FILE GAS WEES CPEATEDITE o- Stelt,2ES PML h eas 


Figure UUP-3. RAMSDEF (Page 1 of 2) 
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youn Five mas oeee PRICUISTS AND A COUAND FILE CLAEPATESIE -- SP CULTEL CHD 


po foe want TO CLOSE THE Coweany FILECIGI TES 
ho Tow WANT TO CEWERATE. A Coemaay FILE FOR FuTUNE USLIMDHT a 


fenty 
id beh ail Pret feces Bate Tine Che TS fos Orer 
Sue as eoT9 GtrO8 PA 12E oo RSE ORIG OFF 


100CL € 962 19-Mor-TH 19- 


OMLT! MAS arcsa:62 


AFaF peek? «= FOLtOe USLO: 10820 
anes 


Fete of 180 Viecks ta U file ta s7ilt, 295) 


Reedy 


Figure UUP-3. RMSDEF (Page 2 of 2} 
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DIRECT PROGRAM 


° New Switches 


/82 List file names, extensions and stzes 
(same sas /SI) 

7oe List open and read regardless file 
access counts 

7MD List files marked for deletion 

7PO List file's position on disk 


/AT or /SA List attributes symbolically 
/OA List attributes in octal 


° Example 


aie SN aren peee Aceess Date Time eis TS Pos. Op/re 
Bit cane “  9t  € 60> 15-Dec-78 1§-Dec-78 dort Pm «8 BASTC2 19128 0/0 
RF:FIX262 FO: 1OX USED: 12:0 RECSI:62 -. COLIMP 

Totel of 11 blocks in 1 file In S$¥:(1,235} 

srt ossl Size trot meceee Dete + Time Clu ATS Pos Op/rr 
$f02 .aAK IL € 60) 18-Mar-79 18-Mar-79 10:95 AM S RT1S 21998 0/0 


Total of 1 block in 1 file fn S¥:(1,235] 


Ready 


Pigure UUP-4. DIRECT 
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BPCREP PROGRAM 


° Reports cross reference of lecal/giobal symbols 


° BPCREF command format: 
“OUTFILE.CRF*=LNFILE.BAC(, INF ILE.BAS]* 
Note the following switches: 


/ SOURCE Include source code Elle 

/QUEVE Queue File for printing 

/NODELETE Don't delete File after queueing 
' /NOHEAD - No header lines (for FILCOM) 

/WIDTH: 132 Line width for cref output 

/ PAGE: 68 Number of lines per page 

/NOCREF No standard CREF printout 

/GLOW:8 Global iow limit 

/GHIGH: 32767 Global high limit 

/LLOW: Local low Limit 


/LHIGH: 32767 Local high limit 

The command “FILE” defaults to "PILE.CRF ef ILE.BAC™ 
The command “FILE/S* defaults to 
“PILE.CRF=FILE.BAC,FILE.BAS” 


© Example 


RUN $BPCREF 4 
BPCREF X7.0-53 RSTS V7.0-53 The ARK / 5.3 
BPCREF command? EVLNES/ WIDTH: 80/LL: S00/LH: 2000/GL: 2000/GH : 5000 


Ready 


Figure UUP-5. BPCREF 
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Ceses Reference Listing of CYLNPS on 22-Oee-78 at lst? PA Page I 

ry ‘ iyyes 

@ jtas lesS)| sare) hese 

© sage 2aas) 8007 

© an? 4035 

@ baa 

: heca yess) = 1688 

9 

e fees) hese 

° 

° 

’ 

¢ 

¢ geele 

eltorrs yezsee tesier 

OLD.4A5RN 

OrTe.orre yozsee 2a7108 

SHS MASHD rene 

Curae yeret 

pcre jore 19850 lees ees) | «6(1eed)| tesee 

iese lose) «jase |= (1086 

OCN.Urod inziee 

ousers 1eace 

ce ores neace 

ctnuros 

ESD. AASEA terre 

CAR 3 

PALCATS 1ecse tese = «feces 

ALO. OCHS 1sse 

a fers «2101S ease eae |= 1608 

TCsOREt ; 

LImes ge33e 19970 19658 1esee se128 | 

Liana 1evse leilee tense erie fee 

ENR. ACE 192108 

tee. arts 

Linn NTs 1915 

LMF SAMS test 1ez1e¢ 

BOLUS ae2ser 

BCONS ' 

meus . 

m3tvs 

ro. OCMSs (let ie7e = 1088 

mACTS 

nases 

MOLOS 

occocss 1esee sees) 1eese Reseed 1068) = =6lesee 

PACKIONS - rete 

PacRiors tee: 

easss 

pis? were 

ect se5s) 61997) ese hte 

est 1ees 0 1097) «18591698 

ers yeqe = yezieg 

PRO2$ ese 382100 

STATS 
Crone Aelecence Lloting of EVLNES on 22-Dec-TH at M2112 PK Pege 2 

vACWTS iazie¢ 


Pigure UUP-6. 


BPCREF Printout (Page 1 of 3) 


vuP-34 ‘COMPANY COMFISENTIAL 


genitals 


srocel tet Ve LATE 


User wisiity pregrecs 


vestee 


TDS 

t renege nezve texse Desie 
TE.etot 

; peye 1072) teas) Bese eee LATIF 
bate p09) 1ege Denieg s0210 laze Lerte 
CMANI$ tee ensee 

UNAMIS yece lexiee 

ursOTs eziee 

UsTATS soos te2i8e 

no. CARESS seniee 

WORDS 192100 


Please chect that the totiewing verisdles have been tataranced properiys 


k.Orrs BLO.BASKS BYTC.OFFS DUNNTS 
puRUEDS TGMOPES LNW ATTS wCONS menus, 
Hptvs Bro. DCMS (18) MECTS MMSSS mQuas 
PAss$ STATE DACHTS urp.ocws (10) uProTs 
wno CARESS woRos 


Crose Beference Listing of EVLNFS on Z2-Dec-76 et GIs? PA 


Clobal range fe 2908 te Sec 


Crone Reference Listing ef EVLNES an 22-pee-71@ at Ost} Pn 
Local cenge in 309 to 2008 


' tees) 1978) (1098 
8 e3s | (1007 
t 1033 
' 
' lscse = nece 
' 
4 
4 leas) ese 
t 
' 
t 
H Ke 
GLO. mA 
acee ye7e | levee 
cent 1 pore | ease Tees Teas 
regee tece | (fece |= (1068 
ounnys ie 
ousorrs 
DUNE OS 
FILCwT® lose = eset 
BLO. OCNS 
TY fers reece Tees 1eet 
owores ; 


Figure UUP-6. 
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Page @ 


yesee 
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: one ry smmepee 
CIGITAL ASTS EL Mas yrcace prepa ALTSVE MHS UPOATE 


User ucllity Prearens : User Urality Programs 


copy PROGRAM 


° Prints warning for disks with bad blecks 
o Reports device causing an error 

° Does not copy bad blocks 

e° Does not copy RPG6 disks 


FLINT PROGRAM 


LeR.tnts hele 1695 
APO .OCHS CIE) weise 19980 1945 e plecubes foster 
OLcoces yese) 10380 1045) «Leese 1esee lose | laces e Zeros flopples 
Beer sacar iv o Supports Rx82 for single density only 
west reree pais . +o Accepts a /NH switch to create an output file 
re Me a ae aan without a without a header record 
stats neiee 
-CLS$ geese 1983 
EFD-OCHS (1A? igsse i068 
Uro.PGs osee 1058 
uro.ess eset 1850 
tro.urod issee lose 


BL. 
MPD.OCHSUIR) «= STATS urn. ocHs (ie) 


Please cheek that the following voctables have been cofecenced properiy: 
MASKS ounrrt punorrs DunurDe 1 ek 


37 Vartabdles 270 ReLerences 29 Statesenta 
#64 Name bytes ta Code bytes 


7? Total tine cru tiee 
R-worde Reserved veed teee 
Date 1.83 1,02 1.08 
Code att 79 38 
Totel a.ee 2.68 3.48 
Ready 
Figure UUP-6. BPCREF Printout (Page 3 cf 3) . 
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FILCOM PROGRAM 


° Accepts wildcards 
© Has new switches 
° 
e 


Includes defaults in its prompts 
Example 


RUN $FILCOM 


FILCOM X7.0-53 RSTS ¥7.9-53 The ARK / 5.3 
File Comparison Program 19-Mar-79 01:29 PM 
Output to <KB:>? 


Input File #1? FIX.CMD 

Input File #27 FIX.BAK 

How Many to Match <3>7 

BASIC¢ Lines <NO>? 

Blank Lines ¢NO>? 7 


Comparing: 1) €1,235)FIX.CMD to 2) (1,235 JF IX. BAK 


1) (1,235 )F IX. CMD 
SY: SEQFIX=S¥:SEQFIXA/MP 
HISEGSSASIC2 : 


2) (1,235 )F 1X. BAK : 
SY:SEOFIN=SY:SEOFIX/MP 
HISEG=3SASIC2 


71 Difference Found. 


Output to <KB:>7 “Z 


Ready 


Figure UUP-7. FILCOM Defaults 
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RUN SFILCOM 

FILCOM X7.0-05 RSTS V7.0-84 Timeshacing 
File Comparison Program 20-Dec-70 09:52 AN 
Output te ¢KB1>? * BAK, ® .EXP/MA: 1/NOBA/BL 


Comparing: 1) {186,7/RMSTST.BAK to 2) [100,7]RMSTST. EXP 
7Input File #2 *(100,7)RMSTST.Exe' not found 
Comparing: 1) (186,7)11024A.BAK to 2) (196, 7) 11024A.ExXP 
PInput File #2 '(106,7)/£1024A.EXP’ not found 


Compacing: 1) [100,7)FILCOM.BAK to 2) (160, 7) FILCOM.EXP 


eT 


1) (186, 7) FILCOM.BAK ; 

BASIC-PLUS CONTINUATION LINES WILL BE CONSIDERED PAR OF A 
NUMBERED PROGRAM LINE (1.6., /MA:3/NOBL/NOBA) . HOWEVER, IT 

baa HOR Oe 

2) (180,7)FILCOM.EXP 

BASIC-PLUS CONTINUATION LINES WILL NOT BE CONSIDERED PART OF A 
NUMBERED PROGRAM LINE (1.E£., /MA:3/NOBL/NOBA) .- HOWEVER, IT 
PARE HRARAR ATED REO ERSTE AR ERAREE 

1) (108,7)FILCOM. BAK 

YOUSPECIFY THE /PATCH SWITCH, FILCOM DOES COMPARE BLANK LINES 
AND DOES CONSIDER BASIC-PLUS CONTINUATION LINES. THAT IS, 

A /P SPECIFICATION OVERRIDES THE NORMAL DEFAULTS AND SETS /BA 
Pan aeae 

2) (100, 7) FILCOM.EXP 

YOU SPECIFY THE /PATCH SWITCH, FILCOM DOES COMPARE BLANK LINES 
AND DOES NOT CONSIDER BASIC-PLUS CONTINUATION LINES. THAT IS, 
A /P SPECIFICATION OVERRIDES THE NORMAL DEFAULTS AND SETS /BA 


72 Differences Found, 


2 Differences Found in 1 File of 1 Total Files Compared. 
Output to ¢KB:>? “2 


Ready 


Figure UUP-8. FPILCOM Switches 
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GRIPE PROGRAM 


oe Allows 4 CTRL Z as well as ESC to end program 
QUOLST PROGRAM 


o Shows more than 65535 blocks as >=65K 
UMOUNT PROGRAM 


© Allows mounting of an unlabelled ANSI tape. 
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Management Utility Programs 


CONTENTS 


Introductionsasccccsccncsenccscvesceressesscseess MUP-1 


Device Testing Packag? (DEVTST)~..-c-cerceceserors MUP-~3 
DEVTST Documentation...ocsceesceseoererercress MUP=3 
Introduction to DEVIST..seeercccncccseerceress MUP~4 
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DSKSEK ErrorS ccccccscccsevecvcsevecsesseverece MUP-208 
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DTEMER ErrorS.sscvosstassnsecscesescenearesces MUP-21 
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Management Utility Programs 


INTRODUCTION 


utility programs supplied with RSTS/E, which relate 
to system manager functions, allow the manager to: 


o Anticipate possible hardware problems and take 
appropriate action. 


o Track system activity during time sharing 
sessions. 


° Gather vital information in case of a system 
erash. 


With RSTS/E V7.6 new management utilities have been 
supplied while others have been enhanced. with the 
exception of system generation and back up related 
programs, this module covers these new and enhanced 
programs. 
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This page is for notes. Management Utility Programs 


DEVICE TESTING PACKAGE (DEVTST) 
1, Supersedes the VETP package 
2. Includes exercisers for: 


ceu 

Disk 

TUS6 DECtape 
Terminal 

Floppy disk 

Line printer 
Magnetic tape 
Paper tape reader 
Paper tape punch 


eo0a0090000 


3. Executes under BASIC-PLUS, BASIC-PLUS-2, or RSX 
Run-Time Systems. 


4. Limitations: 


° CPU exercisers require trigonometric functions 
and matrix operations. 


o No control programs exist 


DEVTST Documentation 
The DEVTST package exercises hardware on the RSTS/E 


V7.0 system ducing normal time-sharing operations. DEVTST 
fs used to stimulate hardware errors on the system. 
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Introduction to DEVTST 


DEVTST {ts 8 package of programs that provides the 
customer, System Manager or Digital Field Service personnel 
with tests that verify the reliability of RSTS/E supported 
hardware. Execution of any DEVTST program is Limited to 
users with privileged accounts. Operational data, 
conventions, complete device testing information and error 
messages are explained in this documentation. After 
execution of individual DEVTST exercisers, users should 
check the System Error Log for additional errors. 


The DEVTST exercisers are tests that can be initiated 
whenever hardware trouble is suspected. These device 
exercisers generate excess activity In an attempt to make 
the hardware fail during operation. 


The DEVTST package should be used in conjunction with 
the ASTS/E Error Logging package. The Error meer ee 
facility provides the means for determining detailed 
{information on hardwace errors. In addition, the DEVTST 
programs return error messages which may be useful in 
determining the fallures however, these messages are not as 
specific as the {Information provided by the System Error 


. Log. 
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Conventions 


The following conventions are used throughout the 
DEVTST package dialogue: 


< > Indicates default answer. 

( ) Shows all possible replies. 

{ ] Gives an optional reply; for example 
ASC[II], means enter either ASC, ASCI or 
ASCII. 


<ALT MODE> or <ESC> This key moves the program back one 
question. If you type this key as a4 
response to the first question, DEVTST 
will return to the RSTS/E command level. 


CTRL/Z The CTRAL/Z combination causes 
the program to sto execution and return 
to RSTS/E comman level. CTRL/2 is 
detected only when the system checks for 
new Input. ; 


CTRL/C Typing CTRL/C causes the program to stop 
execution immediately and return to a 
command level. 


RET Use the RET key to terminate the input 
line. 
Netach <NO> All of the device exercisers have the 


abili{ty to detach; this allows you to 
run an exerciser while keeping your 
terminal free for other operations. 


-1 Negative one, when used as a value for 
number of iterations, peges or lines, 
tells the program to run indefinitely, 
or until you enter CTRL/C. 


wyp-§ COMPANY CONFIDENTIAL 


OTcrrat 


DEVTST Operating Procedures 


ASTS/E UPLATE 


. MANAGEMENT UTILITY PROCAKANS 


To cun a DEVTST program contained within the system 


library account (1,21, type: 
RUN Sprogram name 
For example: 


RUN SKBREXER 


To run a DEVTST program 
account, type: 


RUN (eccount number] program name 
For example: 


RUN (1,215)KBEXER 


from another privileged 


Where program name is one of the exercisers in Table MUP-1. 
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CPEXER 


CPUTST 


DSKEXR 
DSKSEK 
OTEXER 


DXEXER 


KBEXER 
LPEXER 


MTEXER 


PPEXER 


PREXER 


Program Name 


Table MUP-1. DEVTST Programs 


Hardware Tested . 
cPeu 


cPU 


’ FELE STRUCTURED DISK 
NON-FILE STRUCTURED DISK 


DECTAPE 


FLOPPY DISK 


TERMINAL 


LINE PRINTER 


MAGNETIC TAPE 


PAPER TAPE PUNCH 


PAPER TAPE READER 


A complete list of RSTS/E supported hardware, including 
designators and the associated devices, appears in Table 
MUP-2, 
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Table MUP-2, RSTS/E Device Designators (Page 1 of 2) Table MUP-2. RSTS/E Device Designators (Page 2 0 ) 


Device Designator Device 


High speed paper tape 


Device Designator 


DF:, DS:, DK:, DL:,DM:, DP:, 


RSTS/E public disk : = 
DR:, DBs, or SY¥: 


structure as a whole. reader. 
SYts System disk (the unit PP? High speed paper tape punch. 
Tete er eee cae CRs CA11 punched or CM11 mark 
DE": RF11 disk (a11 platters). sense cacd reader. 
DSO: to DS7: RHI1/RSO3I/RSO4 Fixed head cD: CD11 punched card reader. 
Baas en ee ‘ta: to MT7¢ TE10/TU1G/TS83 magtape units 
7. 
DRA: to OKT: RKLI/AKOS disk cartridge @ through 
.units 60 through 7. MM@: to MMT: TE1IG/TUIG/TUAS magtape units 
Ay 
DLO1 to DLJ: RL@1/ALA2 disk cartridge 6 through 
VEEN ere non es MS@: to MST: TS04 magtape units @ through 
DMA: to DMT: RKGLI/RKOG/RKOT —- dL sk 2 ; 
ay enite eee ean LPH: to LPT: Line printer units @ through 
i 7. 
: Te : 
dees toe pla Agee ee me Pack pT: to DTT: qTuS6 DECtape units 9 through 
. 7. I 
DRO: to DRT: k its’ 
? ie ena” Spee DOA: to DDT: TUS8 DECtape II units Mi 


nea: to DBT: 
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RHLI/RPO4/RPOS/RPA6 disk 
pack units 6 through 7. 
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DEVTST Dislogue Errors 


The following error messages may occur in DEVTST programs: 


Message Meaning 
tWarning: (Device Name) Is a DEVTST determines that the 
logical device: (Device Name) device name given fs a 
will be used, logical name for another 


device. DEVTST performs 4 
logical device translation 
and the translated device 
name is used. 


PIllegal device: (Device Name) The device name given by 
speci£fted. the user is elther incor- 
rect or is a _ legical 
device name that cannot be 
translated (for example, 
incorrect characters or 
the wrong type of device). 
Retry the operation with 
the correct device name. 


7Open fallure on (Device Name): This error message can 
(Followed by an error message). mean one of five things: 


1. The device specified 
does not exist, ; 

2. No volume was mounted 
on that device. 

3. Another user has 
ASSIGNed the device. 

4. The volume on the 
device has not been 
formatted. 
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5. The device is not 
on-line or the device 
is not write-enabled. 


To resolve: retry the 
eperation using the 
correct option as 
determined by the error 
message recelved. 


7Illegal number of {iterations Retry the operation using 
selected, . the correct number of 
iterations. 


i 
CPEXER 


The central processor exerciser {s designed to put a 
heavy load on the central processing unit. CPEXER runs 
compute bound for short bursts and then sleeps for five 
seconds so that average processor loading. does not 
appreciably degrade the performance of the system. CPEXER 
was specifically designed to test the FPP option, but also 
verifles general CPU integrity and the ppp11/46 EIS 
operation. There is also a test of the PEEK function for 
kernel addresses @ through 22908. 


: I 
The tests performed by CPEXEA are described In the next 
section. In most of the tests, results are compared to 
known correct values. Two heavily compute-bound tests are 
included. to verify consistent results of duplicate 
calculations. Finally, tests are Included that verify FPP 
divide by zero trap, integer divide by zero trap, Integer 
conversion error and EIS operation. 
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CPEXER Tests 


There are thirteen CPEXER tests included in the CPEXER 
program: 


1. SIN(X) Uses SIN{(X) extended function. 


2. SIN(X) Uses polynomial approximation to SINE 
function. 


3. LOG(X) Uses LOG{(X) extended function. 
4. EXP(X) Uses EXP{X) extended function. 
S. SOR(X) Uses SQA(X) extended function. 


&. SOR(X} Uses Newton-Raphson method to determine the 
square roct. 


. LOG(EXP(X)) Compute-bound test, 

8. ATN(TAN{X])) Compute-bound test. 

9. Aw1.0/8.0 Verify FPP divide by zero trap. 
10. At=18/N% Verify Integer divide by zero trap. 
11. At-69000 Verify integer conversion error. 


12, INT(40.5621*10049.5}/100249.66 Verify EIS 
operation. 


13. PEEKIX} Verify operation of PEEK function. 
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CPEXER Dislogue 
The following is an example of the CPEXER dialogue: 


pun 11,2151 CPEXER : 
CPEXER V7.9-1 RSTS VO7.0-07 The ARK 


How many minutes to run €15>? 1 

Detach <No>? NO 

11.4 seconds of CPU time used in 1 pass. 
CPRXER finished at 12:61 AM 


Ready 


Note 


The CPEXER program will build correctly 
only {£ the version of SASIC-PLUS of 


BASIC-PLUS-2 includes TRIG and LOG. 
These mathematical functions must be 
included during System Generation. 


CPEXER Errors 

This program reports four types of errors: 
1. Instructions falled to execute 
2. Errors failed to trap 
3. Computation errors 


4. Computation consistency checks failed 


Check the System Error Log for reported errors. These 


errors may Indicate hardware problems. 
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When type 1 errors (instruction errors) occur, CPEXER 
prints a two line message: the first line gives the test 
that was being performed and the exact error message and the 
second line Tnaiestes that the test fs continuing. For 
example: 


?CPEXER PEEK falled at memory location m. 
~{ Error Message) 
Continuing..... 


Where: (Error Message) is the RSTS/E error message. 


mis the memory location at which the PEEK function 
failed, 


Examples of type 2 errors (trap Fallure) ares 


2CPEXER Floating point divide by @ didn't trap 
Continuing..... - 
?CPEXER Integer divide by @ didn't trap 
Continuing..... 


Type 3 errors (computation errors) give the type of test 
{SIN, PLYNOM, LOG, EXP, SQR or NEWTON SOR), error in the 
computed value, and the location of the possible error.' For 
example: . 


TCPRYER - SIN test failed for the following cases: 

2CPEXER = Computed value of SIN( 46 ) was .643, should be .64 
?7CPEXER CPU,EIS,FIS,FPP,MUL,DIV of SHIFT Error 

Continulng.... 


Type 4 errors (consistency fallure) in the CPEXER are 
{llustrated by the examples shown below: J 


?7CPEXER - EXP/LOG Consistency check falled for the following 
PCPEXER = EXP(LOG(...¢ 1 DPPPIIIGID <> EXPLLOG(... (1 9D)? 
FCPEXER - =XPPLOT(...( 4 DOVIIIIODD <> ExP(LOG(...04 9900) 
PCPEXER CPU,EIS,FIS,FPP,MUL,DIV oc SHIFT Error 

Continuing .... 
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PCPEXER = ATN/TAN Consistency check failed for the following cases: 
PCPEXER = ATNITAN(,.0(-1.5 DIDDDIDIDD Cy ATNITAN( LS. C-2.SPDDDIIIDDD 
7CPRXER CPU,EIS,FIS,FPP,MUL,OIV, or SHIFT Ercor 

Continuing...» 


CPuTSsST 


The CPUTST dialogue first asks how many minutes you 
want the test to run. The program then checks for 
expiration of this request time at eight strategic points 
during each run sequence. CPUTST then clears and/or sets 
three 2-dimensional arrays to specified values, Matrix A Is 
then transposed and the results placed in Matrix ‘B. The 
transposition is checked by the statement A(J,I) = B(I,J) 
while I and J are belng varied. Any error is then reported; 
if none are encountered, the program returns to the matrix 
clear Instruction. The program repeats this process until 
the run time has expired, at which time {t prints the CPU 
time in seconds of expended job time, 


CPUTST Dialogue 
The following is an example of CPUTST dialogue: 


Run (1, 215]CPUTST 


CPUTST V7.0-1 RSTS VO7.@ 6-97 The ARK 


How many minutes to run ¢15>?1 
Detach <no>? NO 

6.9 seconds of CPU time used 
CPUTST Finished at 18:59 AM 


Ready 
CPUTST Errors 


This device exerciser reports errors as shown In the 
following examples: 
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2cpuTST-Error in matrix transposition routine. 
?l€rroc message) at line mm {n CPUTST V7.8-07. 
Where: (Error message) is the RSTS/E error message. 


mm is the line number in CPUTST where the error 
occurred. 


Check the System Error Log for. reported errors. These 
errors may indicate hardware problems. 


DSKEXR : 


This disk exerciser tests the normal operstion of all 
file structured disks. It is possible to run several copies 
of DSKEXR in order to test several drives simultaneously or 
to put a heavier load on any single drive. The disk must be 
physically and logically mounted. PSKEXR begins by asking 
questions to determine the disk drive to be tested and the 
number of test iterations to be performed. After this 
dialogue, the exerciser opens and extends a temporary file 
to 3 predetermined size which {s dependent upon disk size 
and the number of free blocks. A pattern buffer {is then 
loaded with one of four -patterns (all 1's, all @'s or a 
pattern of alternating 1's and 6's) and the File is written. 
Each block is then read and compared for each of the 
patterns. Upon completion of all iterations for each drive 
specified, s status report is printed. 


Note 


This welte-operation does not use current 
disk files to read and write. The 


temporary ffle will always be deleted 
after use, regardless of how the DSKEXR 
program is terminated, Ae sure to turn 
off data caching before you run this 
test. F 
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DSKEXR Dialogue 
the following is an example of DSKEXR dialogue: 


RUN (1, 215] DSKEXR 
DSKEXA V7.9-1L ASTS VAT.A- 47 The ARK 


Disk drive to test? DBI: 
Number of test iterations <8>? 1 


Detach <No>? NO 


‘No errors detected on DBI): 


Ready 


DSKEXR Errors 

Errors detected by NSKEXA are displayed ae shown below: 
?(Error message) error at line mm in DSKEXR V7.0@-97. 
?nn errors detected on D8n. 

Where: (Error message) is the RSTS/E error message. 


mm is the line number where the error occurred in 
the DSKEXR program. 


nn is the number of errors detected by DSKEXR. 


When errors are detected: 


1, Insure that the volume Is physically mounted and 
write-enabled. 
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Insure that the volume Is logically mounted. This 


may be verified by the use of the SYSTAT program, 
Tf the disk fs not mounted, use the mount command 
of the UTILTY program. 


Caution 


A. Packs mounted ss unlocked public disks 
will be available to other system 
users for creation and storage of 
theifr Files. Subsequent removal of a 
public disk may result in the 
elimination of these user files from 


the system. For this reason, DIGITAL 
recommends the use of a private pack 
{£ a non-system disk Is to be tested, 


Never mount 8 potentially bad disk on 
another drive until you are sure that 
the drive and pack are free of 
physical damage. 


Persistent errors may be due te bad blocks on the 
pack. Any potentially bad blocks will be flagged {n 
the System Error Log following unsuccessful access. 
To prevent further access to defective areas of the 


pack, use the AADS suboption of the REFRESH option 
of INIT. 
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DSKSERK 


This disk exerciser tests the normal operation of 
non-file structured disks by randomly reading blocks fron 
the disk. It is possible to use several copies of DSKSEK in 
order to test several drives simultaneously or to put a 
heavier load on any single drive. If the disk being tested 
{s a mounted RSTS/E Eile structured disk, OSKSEK will not 
read any known bad blocks. If an error occurs on a read 
operation, it will be reported by DSKSEK and logged into the 
System Error Log. 


4 Note 


This is a read only operation. Turn off 
data caching before you run this test. 


DSKSEK Dialogue 
The following is an example of DSKSEK dialogue: 


RUN [1,215] DSKSEX 
DSKSEK V7@8-1 RSTS VA7.8-47 The ARK 


Disk drive to test? DB@: 

Number of test fterations <38>? 1 

Detach <No>? NO 

No bad block detections in 1900 gets from D686: 


Ready 
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DSKSEK Errors 

Errors detected by OSKSEK are displayed as follows: 
?(Ecror message) error at line mm In DSKSEK V7.6-07. 
Where: (Ertor message) is the RSTS/E error message. 


mm {is the line number where the error occurred in the 
DSKSEK program 


When errors are detected: 


1. Check to see 1£ the volume on the testing device Is 
physically mounted. 


2. %€ it is, mount another scratch volume on the drive 
and retry operation. 


Caution 


Never mount a potentially bad disk on 


another drive until you are sure that the 
drive and pack are free of physical 
damage. 


3. %If the test continues to fail, check the System 
Error Log to see If bad blocks are recorded. 


4. Tf bad blocks are recorded, add them to the bad 
block list on the disk using INIT'S REFRESH/BADS 
suboption. This can only be done {If the disk has 
been initialized (DSKINTed) as a RSTS/E disk. 


5. If the problems continue, get s complete listing of 
the System Error Log (using the ERRDIS program). 
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DTEXER 


The DECtape exerciser tests the normal operation of the 
TC11 DECtape contro] and TUS6 DECtape drives. DTEXER begins 
by opening a file on the drive being tested and fills the 
Eile with floating point numbers. The program writes 426 
blocks (of a possible 578 blocks) on the tape. Numbers 
written on the tape are read and checked, keeping a count of 
incorrect values. If at the end of the test the error count 
is not zero, DTEXER prints the error count. 


Caution 


Any information previously contained on 


the DECtape used for this test will be 
destroyed. 


DTEXER Dialogue 
The following is an example of DTEXER dialogue: 


RUN 1,215 }DTEXER 
DTEXER V7,A-1 RSTS VO7.a-A7 The ARK 


Warning: This exerciser will destroy data on the tested 
DECtape. 


Dectape drive to test? DTO: 
Numher of iterations <2>?7 1 


Detach <No>? NO 
No errors detected on DT@: 


DTEXER Finished at 11:68 AM 
Ready 
DTEXER Errors 
This device exerciser shows the number of errors found 


during operation as shown In this exanple: 
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?mm errors on DTn during iteration nn. 


Where: mm is the number of errors detected by the DTEXER 
program. 


DTIn fs the name of device being tested. 


nn fs the number of the {teration during which the 
error occurred. 


When errors are detected: 


1, Check to see if the DECtape on the testing device 
is physically mounted and write-enabled. 


2. %€ it is, mount another scratch DECtape on the 
drive and retry the operation. 


3. Insure that the tape path and heads sre free of 
oxide. , 


DXEXER 


This exerciser tests the norma) operation of the floppy 
controller and the specified floppy drives. ODXEXER starts 
by opening a file 428 blocks long consisting of floating 
point numbers, These are written on the drive being tested, 
then read back and verified. The program then displays the 
number of words written and read, and the number of errors 
detected, 


Caution 


Any information previously contained on 
the floppy disk used for this test will 
be destroyed. : 
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DXEXER Dialogue 
The following is an example of DXEXER dialogue: 


RUN [1,215JDXEXER 
DXEXER V7.0-1 RSTS VO7.6-07 The ARK 


Warning: This exerciser will destroy data on the tested 
floppy disk. 


Floppy drive to test? DX@: 
Number of iterations <20>7 2 
betach <No>? NO 

Floppy disk DXEXER I/0 data 


Device - Reads Words Writes Words 
DRS: 3ng T6.AK 308 76.8K 


DXEXER Errors 


DXEXER shows the number of errors detected dur ing 
operation as shown below: ! 


?mm errors on DXn during iteration nn. MS 


Where: mm is the number of errors detected by the DXEXER 
program. 


DXn is the name of device being tested. 


nn Is the number of the iteration during which the 
error occurred. 


When errors are detected: 


1. Check to see If the Floppy disk on the testing 
device is physically mounted and the door closed. 


2. Qf ft is, mount another scratch floppy disk on the 
drive and retry the operation. 
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RBEXER 


The keyboard exerciser (KBEXER) {s used to test local 
and remote terminals connected to the RSTS/E system, The 
four terminal tests are as follows: 


1. The Space Test verifies that the terminal carriage 
will return rellably from any position. 


2. The ASCI£ Pattern Test verifies that the terminal 
will print the standard ASCII character set in 311 
print positions. 


3. The Worst Case Test forces the head on ASR33 
terminals to rotate a half revolution in every 
print position. 


4. The Repest Test repeats everything typed, one line 
at a time. 


. 


Note 


The tests can be terminated at any tiine 


by typing CTRL/C. HELP can be obtained 
by typing HELP In answer to any dialogue 
question. 


RBEXER Dialogue 
The following !s an example of KBEXER dialogue: 


RUN [1,215] KBEXER : 
KBEXER V7.8-1 RASTS VO7.0-97 The ARK 


Keyboard to test <_KB5A:>? 
Test (SPA(CE], ASC(II], WOR[ST], REP(EAT], HEL(P}) 7? ASC 


Number of test fterations ¢8>?7 1 
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Detach <No>? NO 

***# ROTATING ASCII CHARACTERS TEST *** 
Ste! () #4, -./01234567898 7 So? 2EABC DEF GHIJKLMNOPQRSTUVWXYZ 
- y"eStc' 


KBEXER Finished at 11:44 AM 


Ready 


1 
KBEXER Errors 

Errors detected by KBEXER appear as errors in the 
keyboard test patterns. Visually check the patterns for 
errors, 
LPEXER 

This exerciser prints a rotating pattern of ASCII 
characters on a specified number of pages and fs used to 
test any line printer. ' 
LPEXER Dialogue 

The following is an example of LPEXER dlalogue: 


RUN [1,215] LPEXER 
LPEXER ¥7'.0-1 RSTS VO7.9-07 The ARK 


Line printer to test? LPA: 
Number of pages to output <4>? 1 
Detach <No>? No 

LPEXER €inished at 11:35 AM 


Ready 
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LPEXER Errors * 


Probleme found on the line printer appear as errors tn 
the print-out of ASCII characters. Visually check the line 
printer listing and {£ an error message {ts printed by 
LPEXER, check to make sure that the line printer selected is 
on-line and not out of paper. 


MTEXER 


The magtape exerciser checks normal operation of the 
M11 magtape control or RH11/T482/T™O3 controller and the 
speciffed number of 7-track or 9-track TE1@, TEI6, TV1d, 
TSA3, TUS, TU45 or TSOA drives. MTEXER allows you to 
select the drive to be tested, the length of tape to be 
written and the number of iterations to be performed. For 
each fteratfon, MTEXER zeroes the tape, opens a flie and 
writes data until the specified length of tape has been 
used. MTEXER then rewinds the tape, opens the flle for 
input, reads and verifies the data. If errors are detected, 
MTEXER prints a count of the number of bytes found to be 
incorrect; MTEXER then proceeds to the next iteration. 


The data pattern used is a worst case NRZI pattern for 
9-track drives; it Is not worst case for 7-track recording. 
The pattern is loaded Into a 512 byte buffer and,, 
successively greater numbers of records are written to the. 
magtape until the requested length of tape has been written. 
Furthermore, the pattern base varies with X so that the 


contents of the pattern buffer also varies on successive 
{terations. 


Caution 


This exerciser will overwrite data 
contained on the magtape used for the 
test. 
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MTEXER Dislogue 
The following is an example of MTEXER dialogue: 


RUN -f1, Z1S]MTEXER 


- MTEXER V7.0-1 ASTS V97.6- a7 “the ARK 


Magtape drive to test? MTG: 
Density (800 or 1600) <ABd>? 1698 
Number of feet to test <100>7 25 
Number of iterations <2>? 1 
Detach <No>? NO 


Magtape MTEXER 1/0 Data 


Device Reads Words Weites Words 
MTA: 
54 24,5765 K 96 24,576 K 


No errors detected on MTO: 


Ready 


MTEXER Errors 

Magtape errors are reported in these formats: 
?Magtape select error at line nn in MTEXER V7.0-87. 
?MTEXER-Selection error occurred. 


Where: nn is the line number In MTEXER at which the error 
occurred. 


When errors are detected: 
1. Check to see If the volume on the testing device fis 


physically mounted, weite~ enabled and assigned to 
you. 
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2. %If it Is, mount another scratch volume on the drive 
and retry the operation. 


3. ipeuee that the tape path and heads are free of 
oxide. 


N 


PPEXER 
This program tests the normal operation of the paper 


tape punch by punching random patterns on the paper tape for 
Input Into the PREXER. 


PPEXEN Dialogue 
The following Is an example of PPEXER dialogue: 


RUN [1,215] PPEXER 
PPEXER V7.@-1 RSTS V07.9-07 The ARK 


This test wlll punch a binary count pattern tape. The tape 


wlll be equivalent to MAINDEC-N0-N2G4 entitled Special 
Binary Count Pattern Tape. 


Detach <No>? 


The generated paper tape may be used to test the paper tape 
reader 


PPEXER Einished st 11:23 AM 


Ready 


PPEXER Errors 


Problems in the paper tape punch will result In an 


incorrectly generated paper tape which is detected by PREXER | 


when the tape is read. {tf PPEXER prints an error message, 
check to see that the paper tape punch {s on-line and not 
out of paper tape. 
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PREXER 

This program tests the normal operation of the paper 
tape reader by reading the paper tape punched by the PPEXER 
program. 
PREXER Dialogue 

The following {s an example of PREXER dialogue: 


RUN [1,215] PREXER 
PREXER V7.8-1 RSTS VO7.6-07 The ARK 


Load MAINDEC-f0-D2G4-PT or the binary count pattern 
tape generated by the punch exerciser into the reader with 
the leader under the read station. 


Detach <No>? NO : 
No errors detected on paper tape. 


PREXER finished at 11:29 AM 


Ready 


PREXER Errors 
PREXER errors are reported in this format: 
?nn errors detected on paper tape. 


Where: on is the number of errors detected by the PREXER 
program. 
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MANAGEMENT UTECITY PADSA 


Note 


1€ the paper tape was loaded backwards 


and the reader ig operating correctly, 
the following error message is printed: 
215340 errors detected on paper tape. 


Any other errors detected by the PREXER may Indicate a 
hardware problem. 
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ON-LINE 
1. 


2. 


* ; Beer Le 


PASECESRNT UTILITY Foo ee 


sees 


CLEAN PROGRAM - ONLCLN 


Provides the same 'CLEAN' as the REFRESH option of 
INIT. 


' 


Executes under the AT11L Run-Time System. 
Example dialogue: 

RUN SONLCLN 

Disk? DMA: 

Disk is being cleaned - walt... 

Disk? “C 


Ready 


Note 


pisk must be physically, but not 
logically mounted. 
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ENHANCED MANAGEMENT UTILITY PROGRAMS 
Spooling Package 


1. Programs and thelr related files can reaide in an 
account other than [1,2]. 


° OPSER Program 


Reports the keyboard number from which a 
message to the operator has been sent 


For example: 


MESSAGE 8&5 2 OF-Har-77 07548 AM JOBI20 KBB! PLEASEC100+73 
PLEASE MOUNT MAGTAPE LABELLED *TESTS* ON HALS 


Figure MUP-1. OPSER Message 


o QUEMAN Program 


New Interrupt commands 
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Command 


DIS [ABLE] 


ENA (BLE) 


pret f SP LaTe 


MAROC ENT STIL TY PEt hes 


QUEUING} <text> 


SPO[OLING] <text> 


All <text> 


QUE[UING) <text> 


SPO[OLING] <text> 


All <text> 


wUP-33 


Table muP-3. New Interrupt ‘Commands 


Meaning 


QUE stops sending 

messages to QUEMAN 
and stops listing 

the queue. 


QUEMAN stops 
sending job 
requests to all 
spoolers. 


Both QUEUING and 
SPOOLING are 
stopped. 


QUE resumes 
sending messages 
to QUEMAN and 
enables listing 
the queue. 


QUEMAN resumes 
sending job 
requests to the 
spoolers. 


Both QUEUING and 


SPOOLING are 
enabled. 
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° QUE program 


New commands 


F FLUSH A QUEUE* 
s SHORT QUEUE LIST 


CCL command 


Recognizes the CCL command SUBMIT <filename> 
and spools the file for batch processing. 


* Privileged operation 
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SYSTAT Progran 


RUN ESYSTAT ™. 
SISTA 27.0-@S ABTS V7.O-84 Tiweshecing 
Durpet Seetve tor 


RSTE ¥T.0-04 Tinsenating status st Ad-tow-78, 3:00 PR Ups 31509097 


Job wna Were «wnat Bre State = Run-Tise ats 
1 UPR Det eeacey S/11k | 8k OEE 4 OASKE a 
2 orn Det Orsauw 15/938 St pasic? 
3 foray = bet Quenue 16/218 Bt ote Basar 
a 1,267 BOS6 psnone = O/3IR oat 
$ {orAy = Det pateus ES/3)R GL 
‘6 jorey = Det BATION 19/31R SL OSE 
? OrAag = Det BATIOL 33/3IK SL DS? 

@ , foray dae ad 1esaye $A Ose 
’ foray bet Wexovn § G/21R | SR 

fe foray = Get OYw.2R | 2/3IK SL 
" 1,224 nee SYSTAT $6/30K “¢ 
2 foray = Det SPLIOL 16/31K SL O62 Baser 

vy 2,215 wend wreort 27/318 FO eco 

4 2,262 xeay BuRAMe OG/IR °C Sricon 
us 21,238 £83) oe BOD 20/90K “Cc Als SF ICOM 
is i.20@ naz? mosane 231K “CARY Baser 
n 1.200 KO24 SYSTAT O/¥RR WC BASF 
18 2,23k Dat STAPEW | a/3RR OBL gasee 
as 3,219) e2S gue Ess “¢ Ag? easir 
ae 4,282) 8891 VTCOIT 20/31R 8B ACE TECO 
Pay 4,322 BIS BONAME §=.2/33R OC AOE RASEP 
20) 2.245 682200 meTRR G7)IE OSL BAser 
n 2.220 O20) «= VTEDIT 17/)IK RB AGT TECO 
26 1,243) Kees ao eThO C47200 0 1H AO) oe RSE 
5 2,237 “647 vreoir 17/220 0 ap ALT Tico 
26 1,225 RO3@. «-VTCOIT 20731R FD TIC 
” 2,222 R926 TTyseT Jes}in “Cc Aad caser 
20 2,247 oad DseomP LS/PIR | TC ASS paser 
23 1,297 aBly evenrs U/NIR °C easat 
eT) 2.710 RO2T wWowAME = =-3701K WC AOE BAS ar 
Ty 2,230 #832 WuWANE = -a/)IR TC AND easier 
eri 2.236 RO22 MONARE praiht “c ARS BASAT 
> 1.248) POTS SYMBLO «66/318 AN BASIt 
ac 3,245 R934 SYSTAT 1O/)IK "CAMS easar 
35 1,744 RBG SYSTAT 38/HIR “C Aster 
% {secey e076) SysTAT 3a/31@ AH Uck easar 
nN 2,233) Pile FT.V2 A6/31R 0 RW RASVIS 

Guay Devicess 

Device Job Why 

exe $ AS*1NET 

pal 9 IwiT 

ane ase AStNIT 

mal ase AStUNET 

xn? ase AS*UNeT 

ane 8 AS*ANST 

nnd 3 agonast 

Biek Structure: 

Disk Open Free Cluster Errore Nove Cosments 

ose e) éon » SvAP@ Ped, DLA 

Dot i i J Pea. NES 

ohe F] e Pod, Poo. NPS 

tee ry sie 5 e veec fra, b-u, Ei 

pen ” yous ' e abe Pav. ft 

ta? ? iszete . e ve tea, fis 


Figure MUP-2. SYSTAT (page 1 of 2) 
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Small Large Jobs Hung TTY's Ecrocs 
41 1 37/63 8 398 
Run-Time Systema: : 
Name Ext Size Users Comments 
BAS «Fr BAC 16(16)K 26 Perm, Adde:46, KBM, CSZ 
HI5STOG 28(4)K @ Perm, Addc:268, KBM, CSZ, EMT: 285 
BASIC BAC 16(16)K Q Non-Res, KBM, CS2 
TECG TEC 8(24)K 5 Temp, Addr:296, KSM 
RTL SAV 4(26)K 1 Temp, Addc:216, KBM, CS%, EMT:255 
RSX TSK 3(28)K Q Non-Res, KBM 
R451] «TSK 4aq2ayn 8 Non-Res 
COBOL TSK 4(28)K @ Non-Res 
BASIC2 TSK 16ql6)K 1 Temp, Addr1i63 
BP2COM TSK 4(28)K 2 Temp, Addr:179, KBM 
BASICY SK 16(16)KR 2 Non-Res 
BPYCUM TSK 4(2aj)k t] Non-Res, KBM” 
RMSVI15 TSK aczsyx ol Temp, Addr:184 
sone Prot Acct Size Users Comments 
RMSRES ¢ 42> { @.1 ] 23K 8 Non-Res, Addr:66 
Message Receivers: 

_ Name Job Msgs Max Senders : ; 
ERRLOG 1 ] 4a Priv ‘ 
GPSER 9 38 Local 
QUEMAN 3 8 68 Local 
BAGSPL 5 6 5 Priv 
BAISPL 6 8 5 Priv 
BA2SFL 7 8 5 Priv 
acy 6 6 5 Priv, Network 
NAPKOD 9 6 5 Network 
LeyseL 12 ] 5 Priv 
NSIT22 22 ] 5 Network 
HFT.370 (3? 6 5 
Ready 


Pigure MUP-2. SYSTAT (page 2 of 2) 
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Three new privileged switches 


/O[:DEV) - list open files (large file systems 
only) 

/MUrDEV] - list open files and jobs accessing them 
(large file systems only) 

/C = list memory allocation 


Table MUP-4. Status Codes 


Code Meaning 

Pla Flle is placed 

‘Upd : File is opened in update mode 

Nok File cannot be renamed or deleted 
ued File is a UFD 

etg File 1s cont iquous 


Md File ts marked as deletable 


Table MUP-5. Job Access Codes 


Code Meaning 
Rd Job has read access 
Rr File opened read regardless 
We Job has write access 
Tent Fille fs a tentative file 
ca File opened with data caching 
Sq File opened with sequential data 
; caching 
Up Flle opened in update mode 
Spup File opened in special update mode 
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Open Files: 
DSO: -- Null List 
DM]: -- None 


DBG: -- None 


DBI: -- File 

DBl:{ 1,235)SYSO .LST<6@> 
pDBl:{ 1,247}D1SKID.BAS<60> 
OB1:{ 2,281] BUFMAP.B2S<60> 
oBis{ 1,258] 

DBI:{ 2,201Lj/TEMPI4.THP<68> 
DBI: { 2,201}TMP214.7MP<60> 
DBI: {159,34 JHRK  .THPCAB> 
pB1:1150,34 JCREF .THP<49> 
DB1:{ 1,2 JMACRO .SAV<104> 
DBI: | 1,10 )BATCe6.WRK<6O> 
DBI: { 1,10 )SPLOQ4.WRK<68> 
CBl:§ 1,10 JCHARS .QUE<68> 
DBI:{ 1,18 JBATCOS.WAK<69> 
DBI:{ 1,18 JBATCO7T.WRK<68> 
DBl:{ 1,10 JOPSLG1.LOG<60> 
DB1:{ 1,2 JOPSERO.WRK<69> 
DSi:] 1,2 JOPSERL.WRK<4O> 
CBl:{ 1,2 JQUEVE .WRK<60> 
DBI: | 1,2 JQUEUVE .S¥5<40@> 
pDB1l:{ 1,2 JTEMPO3.QUE<68> 


DB2: -- File 
pB2:( 1,2 


Pigure MUP-3. 


Myp-TA 


}BAS1C2.TSK<¢104> 


Revie uprace 
MANAGEMENT UTILITY PAI IANS 


Op/RR Size Clu Status 

1/8 8, 8 

1/8 26 8 

1/8 2 8 

1/8 48 16 Nok, UFD 
1/8 22 8 

1/9 126 8 

1/98 0 8 

1/8 25 8 

6/1 $7 8 

1/6 13 8 

1/0 9 8 

1/8 2 8 

1/8 13 8 

8 ll 8 

1/6 6 8 

1/8 2 8 

3/6 2i 8 

1/8 23 8 

2/8 4a 8 

1/8 105 8 

Cp/RR Size Clu Status 
o/1 465 8 ctg 
SYSTAT /0 
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Open Files and jovs aceesaing thea: 


DSOr ~~ Mull Afet 


tml: -- Kone 


Deer -- Hone 


OBls o- Pile 
B11 (158,34 ICREP 
aq 


DBint 


pair 


pelsd 


oelet 


osint 


OBAst 


OBlef 


Daial 


DBitt 


DBiit 


DBitl 


DO2e -- Pile 


Geen 
~TMPCAO> ra | 
Rd, We, Tent 


1,2 JMACRO .SAVCLOd> O/1 
i?) Ad, RA 


2, 20LJEVTAQS.B28<68> 1/8 
14 ad 

1,18 )BATCOG .WAKC6BD 178 
€- Rd, we 


1,16 |SPLOO4 WRECEBD 1/0 
a Rd, We 


1,18 JCHARS .QUE<és> 1/6 
a Rd 

1,1@ }BATCOS.WRK<6@> = 1/8 
3 ad, We 


1,18 ;BATCHT.WRKCEOD 1/8 
! Ad, We 


1,18 JOPSLE1.LOG<6E> 1/8 
2 ad, Wr 


1,2 FOPSERS.WRK<6ED 3/0 
2 Rd, We 


1,2 JOPSER] .WRKCAO> ase 
as 


1,2 JQUEVE .wRKCGS> 1/6 
3 ad, We 


4,7 joueut .syscés> 370 


iy nd 
26 Rd 
3 ad, Wr 


Op/ RR 


0B254159,62 JWRITE .MACCIE> we 
3200 Ad 


Figure MUP-4. 
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Site Clu Status 
8 8 
$? t 
is a 
13 a 
? 8 
z 8 
13 i] 
iM 8 
6 s 
2 8 
ri} 8 
23 8 
as 8 

Stee sie Status 
SYSTAT /W 
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MANASEMENT otiiecy PANTaAes 
i 
SY/C 
Memory allocation table: 
Start End Length Permanent Temporary 
OK - 46K ({ 47K) MONITOR 
47K - 62K ( 16K) BAS4F RTS 
63K - 142K ( 80K) ** XBUF ** 
143K - SOK ¢ 8K) TECO RTS 
151K - 178K ( 26K) HISTOG RTS 
179K = 179K { 1K) {Userc) 
18@K - 202K ( 23K) (User) RMSRES LIB 
203K - 204K ( 2K) (User) COBOL RTS 
205K - 206K ( 2K) (User) COBOL RTS, FOO RTS 
207K - 207K ¢ 1K) (User) FOO RTS 
ZO6K -— SIIK ( 304K) (User) 
$12K - *** END *## 
Ready 


Figure mMuUP-4A. 
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vrseery (VTSDPY) Program 
1. New command for resident libraries 
° Command Meaning 
R Displays resident library data. 
oH H preceded by a minus sign renoves 
the data from the screen. 
2. Memory display for resident libraries 


‘sn- where n fis the library's position in the 


resident library list. 
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TTYSET Program 


1. 


ttm ee 


RSTS/E UPCATE 
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Macros for new terminals include: 


LA34 
LA38 
LA126 
vT 190 


MUP~42 
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error Logging Package 


1. 


2. 


3. 


Recognizes and reports errors for new devices. 


Programs and their related files can reside in an 
account other than [1,2]- 


Always reports the block number of the disk block 
that caused an error. 
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PTITITITITITITIT TLL) 
DR RH11/RM02-03 Seq #16 Occurred on 17-Nov-78 at 08:12:48 AM 


User Description: 


Job Number 

KB Nuober 

Account 

Progras Nane 

User Job Physical Addr. 
Wser Job Size 

Control Parameters 

RIS Name 

RTS Physical Address 


Detailed Description: 
1/C Status 

Ticeout Indicator 
Cffset Position 
Gverlapped Seek Ind. 
Unit Size in DC's 
Device Cluster Size 
Pack Cluster Size 
Logical hame 

Prysical Nase 


1€ 

33 
{1,250} 
PACKID 
01100000 


BASE 
00270000 


000 

000 
Previous 
000 
100220 

4 

r 


DRt: 


weasc2] prock Number : 


pSQ 


o00gco §=617404h 0723454 000007 
000001 002171 106266 176000 
000000 0613700 00000 000048 
000000 002002 127600 0004900 


002400 192044 90000) 
015734 ooddde 00000 


o00000 econ00 000000 


Figure MUP-5. ERRDIS (page 1 of 3) 
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CSR Address 


PStosE SECEDE 
WANAGEMENT UTILITY PADDIAMS 


176300 


Contents of Registers 


RMCS1 160200 
RMR 900000 
RMBA ooc000 
RMDA 000000 
RUCS2 010101 
RUDS oooode 
RMERI 000000 
RHAS — co0000 
RMLA 000000 
RMMA 1 000000 
RMDI 000000 
RHSN 900000 
AMOF 900000 
RMDC 090000 
RMHR 000000 
RMMA2 ooocc0 
RMER2 000000 
RMEC! 000000 
RMEC2 000000 
RMBAE 000000 


RMCS3 000000 


Figure MUP-5. 


MCPE Bus Err TRE Xfer Err 


ERRDIS (page 2 cf 3) 
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Table MUP-6. ERRDIS Mnemonics 


COOTIITII I rriiiiititiiriirtitiiiiiirtiritiiititirrititiiry) Mnemonic Description 


XM DMCII HPR Inter. Seq #613 Occurred on 16-Nov-78 at 02:59:59 PM - 3 


Undefined Interrupt 


DR RH11/ANG2-03 
Detailed Description: Dx RXLI/AX211 
werner eete n-ne n enn ene DD TU58 
Timeout Indicator 000000 TS TS11L/TSO4 
Physical Name MI: 


Unexpected message* 


DDB 000010 000403 900000 o40001 
192400 001035 00000 027640 
023006 000000 900000 0N0000 
073532 900005 027540 900200 
oe000d 000000 900000 900400 
000000 Oncn0D NNN000 oDNR00 


) * eceived from the monitor. 
DDB Extension 000000 0276450 018200 021080 A message not € 
000000 027650 o00000 027654 


G00000 027660 000000 027664 
000000 000000 002004 900000 


CSA Address 160160 
Contents of Registers 

SELO 100000 

SEL2 046701 

SELa 900000 

SEL6 000200 


Figure MUP-5. ERRDIS (page 3 of 3) 
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UTILTY Program 
1, New Commands Includes 
Command 


SELZE DEV: 


ADD LIBRARY LIBNAME 
/ADORen 


/STAY 


/LUSER 


fiw 


/NOLOGERR 


/ REMOVE 


ASTS/E UPDATE 
MANAGEMENT UTILITY PROGRAMS 


Meaning 


Assign “DEV:" even {if it Is 
currently assigned to another 
job, unless a file is open on 
the device. 


Add “LIBNAME" as a Resident 
Library. 

Load Library in memory at 
address n, which Is a 1K section 
of memory. 

The Library should be 
permanently resident. : 
The Resident Library {s to 
handle only 1 user, rather than 
be shared code. 

The Library should be mapped 
Read/Write, rather than 
Read-Only. 

Errors occurring within the 
Library should not be logged to 
the system error log. 


The Library should be : 


immediately removed from memory 
when all jobs using it detach 
from the library. 


Note | 


The /ADDR: switch must be specified with | 
the ADD LIBRARY command. 


REMOVE LIBRARY LIBNAME Remove “LIBNAME” as a Resident 


Library. 
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LOAD LIBRARY LIBNAME 


/ADDR:n 


/STAY 
UNLOAD LIBRAR 


LIST CACHE 


ENABLE CACHE 
/ALL 


/FILE 


/NOFILE 
/ BUFF 


/NOBUFF 


/CLsn 
/LIMITin 


/DIRin 


/DATA:n 


DISABLE CACHE 
AUNBURST nO 


SIZE n Q 


FLAG filename 


/CACHE 


Y CIBNAME 


WRSASEMEST ITE 


Load Resident Library “LIBNAME® 
in memory. 

Load Library in memory at 
address n which is a 1K section 
of memory. 

The library should be 
permanently resident. 


Unload Resident 
"LIBNAME" from memory. 


Library 


List current cache settings. 


Enable directory caching. 

Cache all data transfers 
regardless of OPEN mode. 

Enable data caching based on 
file and OPEN mode. 

Disable data caching. 

Small buffers may be vused for 
caching. 

Small buffers may not be used 
for caching. 

Cache Cluster Size 

Total } of Cache Clusters which 
will be used. 

Total } of Cache Clusters which 
can be used for directories. 
Total # of Cache Clusters which 
can be used for data. 


Disable all caching. 
Change jeb n's runburst to Q. 
Change job n's maximum size to Q 


Modify file's directory based on 
the Following switches. 


Flag file to be cached 


automatically when the file is 
opened. 
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SNOCACHE 


/SEQ 


7 RAN 


/PLACE 
/NOPLACE 


/NOCTG 


ASTSZE JPRIATE 


MANAGEMENT UTILITY PROGRAMS 


Do not automatically cache the 
file when it {is opened. 


Set file's default caching mode 
to sequential. 


Set file's default caching mode 
to random. 


Flag flle to be a placed file. 
Flag file as not being placed. 


Flag file as not being 
contiguous. 
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prance 
% me ae > 
MANAGEMENT UTILITY FEODEENS 


ANALYS Program| 


1. 


2. 
3. 


4. 


New switch on output file produces an annotated 
version of a memory dump. 


Additional information in the dump file. 
New device support 


Resident library support 


RUN [1,10] ANALYS 

ANALYS X7.8-85 RSTS V7.0-94 Timesharing 
Input <[0, 1] CRASH.SYS>? 

Out put_<KB:ANALYS. DMP> 2ANALYS . DMP/WIDE | 


Crash Error Log Filename<{1,10] ERRCRS.FIL>? 


Ready 
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ISITAL 


Aearyoie of 00, SICPASH.STS/SIL:S19:10, Y)ASTARL. SIL 


Taaen en greNewnsG at COs 3C AM 


spaces was cenfagered with SEChet ek 


ise 


was cerfigured fcr targe Ctles 


Crosm Dump Stetue Free tb-hov-78 et 13:32 AM, pr gbrerrt 


tend wre buere bret 
, 1a Bet eneced 
a 1,50 Bet CPSECh 
7 1,10 bet QUAIL 
s 1,10 Det 
$ WIC fet 
§ 1,10 bet eacare 
1 1.10 fet BATPLR 
t 1,10 Set acy 
1 1,10 Det SPLER 
* 1.10 Cet [at Bri] 
" V,258 Rech RC HAME 
WwW i Pelt bcrer 
rd coer VWecid 
rr Ltt | vite 
Pry mEs8 OATES 
ui thst | NCWAME 
tusy Bevites: 
serdce cen wny 
Lied 7 aSeanit 


my SP OSei hit 
Ing wsP RSoIHIT 


tak Strveture: 
tise Coan free 


Sire 
Sri 
three! 9 
WEEK 
Wes 
Veetye 
W328 
VS s3ie 
wera 
sie 
arp 
Prac 3 
aeuie 
W791 
10751K 
Piel 3 
aeaik 


Stete 
Re 086 
sk 
St 
SL DST 
st 
hie 
Si 
sa 059 
se 
St 
“€ 
OB Uck 
ep are 
ce aoe 


“c a0 


Cluster Erroré Nase 


3s Mi ° 6 
ost 1 ' 
two 6 yTeis 1 
rs 9 Lil} s 
¢ $120 J 
: Veet 6 
‘ 1$08ee § 


DEC: + Wik Stst 


we: — Sere 


Bore 
Str a were 


Tht ee Pile 


acocedo 


Run-Ties Pri/RB ATS 
6:56.08 O76 faser 
2:20.70 -8/8 BASIC? 

10:58. -B/0 | BASSP 


0.5 678 Baser 
oO.) ~8e3 baser 
0.3 -879 ASAP 
g.t 875 Baser 
W.$ 073 BASEE 
12.5 -6/2 BASE 


19:09.0 320710... RSK 
7:87.07 BASIE 
2109.8 -80/5).. RSE 
13.6 Ove TECG 
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SHUTUP Program 


1. Additional information in printout 


RUN SSHUTUP 
SHUTUP X07.9-1 RSTS V07.@-83 TIME SHARING 


12:24 PM 22-Sep-78 EEEIEE Set-up Dialogue Phase BPHTTIEE 
Type ‘ESC’ ('ALT') to any query to backup one (1) step 
"OPSER’ not running 

Minutes until system shutdown (8-99) <5>? ) 


12:24 PM 22-Sep-78 FUFERE Warning Message Phase FRETS 
Further LOGINS are now disabled 


22-Sep-76) FULENE Initial Job Killing Phase PEGTPE 


22-Sep-78] FEIREF| Remove RTS/RES LIB Phase UEFERE 


22-Sep-76 #F99#8 SWAP File Removal Phase FHIIEE 


22-Sep-78) SUEEVE Ofsk DISMOUNT Phase EUGOTS 


22-Sep-78] FEEREE Final Shutdown Phase Gftttt 


Please wait for system to re-boot itself 
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LOGIN Program 
i. Hes a spawned entry point for use by the BUILD 
is package. . 
MONEY Program 
1. Reports accounts using more than 65535 blocks on 
the public structure as > * 65535 In the “blocks 
used” column. 
i 
DSKINT Program 
1. Supports new disks. 
2. Reports the current PACKID and Pack Cluster Size if 
disk already has 4 RSTS/E format. 


REACT Program 
1. Sets the protection code on ACCT.SYS to 128. 


ODT Program 


1. Supports large Files 
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1. BATCH 
2.  ANALYS 
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Monitor Internals 


INTRODUCTION 


The ASTS/E monitor performs a multitude of 
functions for its users. These functions include: 


Scheduling jobs to be run 

Performing all device operations 
Performing all flle related operations 
Managing all resources on the system 


QgQoo0aq 


In actuality, the monitor is responsible for the 
harmony and security which RSTS/E users have come to 
take for granted. 


In this module you will learn about the changes to 
the monitor in RSTS/E V7.8. These changes involve not 
only the format of a RSTS/E monitor as it resides on 
disk prior to system start up, but also the operational 
and structural changes which affect all users during 4 
time-sharing session. 


wet covery 


DISSTAL : 
RSTS/E SHS uPsar ; 
Cours : BCTO“ZE Tal SPIRTE 
Monitor Incernats ese te es spe 


This page is for notes. 
MONITOR MODULES 


RSTS 
o Data structures for monitor, device and job 
management 
o Non-disk interrupt routines 
o Some monitor code 
TER 
i 
o «Terminal driver routines 
o 8 «©©Mini SYSTAT routines 
DSK 
o Disk interrupt routines 
° Disk driver code and error logging routines 
EMT 
° Monitor call handling routines 
° Resident library handling and mapping routines 
o Scheduling and swapping routines 
° Memory management routines 
FIe 
° Directory handling routines 
() File operation routines 
o FIP £unctlon handling 
o SAT handling routines 
RSX 


° RSX directive emulation routines 
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ODT 


DEFALT 
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Routines not made permanently resident dur 
SYSGEN : 108 


Monitor ODT code 


Default settings for the monitor 
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MONITOR AS A SIL ON DISK 


During system generation the monitor modules are 
assembled and linked. Following this process the SILUS 
progran {8 run to convert the linked monitor into a save 
image lfbracy (SIL) format. It fs this SIL format which 
makes autopatching of the modules possible. 

This section covers the format and Information 
contained In a save image library. 
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Figure MON-1. Monitor on Disk (A Save Image Library) 
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Number of Modules in SIL 
Sin module entry BL 


1-{5 rodule 
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Figure MON-2. Index Block (Pirst Block in a SIL) 
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SE.NAM 


SE.ION 
SE.BLK 


SE.STB 
SE.STN 


SE.LOD 


SE.SIZ 


Pigure MON-3. SIL Module Entry Format 


Module name in RADSO 
Module’s . IDENT In RADS®O 
Block offset to module within SIL 
1 First module usually 
@ A SAV format SIL 
Block offset to module's symbol table 
@ Module has no symbol table 
Number of symbols in module's symbol table 
0 Module has no symbol table 
Virtual address {nto which module "loads' 
Lowest address In the module's image 


Low Limit Monitor SIL 

Low limit RTS 

Lowest Limit Non-PI¢ LI8 

OSDID1 Pic LIB : 

090936 SAV format SIL and INIT.SYS 


Virtual sddress ‘size’ of module 
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The first {fllegal address of a module is SE.SIZ 
plus SE.LOD 
High Limit Monitor SIL 
177776 RTS 
Highest address Non-PIC LIB 
Highest address Pic LIB 
Highest address SAV format SIL 
Virtual transfer address of module 
Only SAV format SILs have transfer addresses, 
808091 means no transfer address 
Size of module on disk in blocks 
For non-overlaid modules: 
SE.SZ7D = (SE.SIZ + 777)/1900 


For overlaid modules (LIBS and overlaid RT11 
Programs in SAV fermat SILs} 
SE.SZD > SE.SIZ 


SE.SZD = @ ; SIL format of previous 
RSTS/E releases 

Block offset to module's overlay descriptors 

Number of overlay descriptors for module 


SE.OVB = @ 
SE.OVN 


Monitors and RTS’ 


Note 


Any module which starts on a 1800 byte 


multiple and is not overlaid does not 
need overlay descriptors. Any module 


which starts on a non-1800 byte multiple 
(e.g. INIT.SYS), which has data below 
its start (e.g. all RT11 programs), or 
which {is overlaid (e.g. LIBs) require 
overlay descriptors 


SE.XXX 


Reserved for SAV format SILs. Contents ‘random’ 
to all but the RT11 emulator. 
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Pigure MON-4, 


RSTS/E SWS UPDATE 


Monttor Internals ppniees 


1. 


a4 dese. no. 


e ROG 


Symbol Table Entry Pormat — 800/ 


820/ 
040/ 
060/ 
168/ 
120/ 
140/ 


160/° 


280/ 
220/ 
240/ 
260/ 
300/ 
320/ 
346/ 
360/ 
400/ 
420/ 
44a/ 
460/ 
500/ 
§20/ 
546/ 
560/ 
6090/ 
620/ 
640/ 
660/ 
700/ 
720/ 
740/ 
760/ 
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EXERCISE 


FETS/E SwS UPDATE 
“onitor Internals 


Using the following octal. dump of a SIL index block, 


680012 
608000 
000000 
120006 
000008 
120608 
600808 
1200006 
900000 
120090 
eaoged 
129008 


126680 
900080 
802008 
690089 
140000 
6608600 
601800 
oo0008 
998608 
900008 
000000 
900009 
000000 
609008 
090008 
9908990 
600008 
300000 
800000 


BLOCK NUMBER 00008 


071614 
140990 
076732 
021006 
816083 
610000 
020534 
817000 
623370 
0276090 
071620 
8670008 
8552186 
820000 
660502 
673060 
057164 
012529 
014716 
0020098 
g00000 
gagee0 
996808 
600008 
bonged 
800900 


‘000008 


6000098 
odee0d 
geoead 
eeo0ne 
e00008 


073398 
680081 
000068 
900081 
000000 
609801 
800008 
809081 
800008 
oaee8el 
000008 


06006) 


990008 
000001 
000080 
060091 
090308 
142522 
004664 
690001 
060908 
000098 
e00000 
990008 
Go0bed 
800000 
000000 
020820 
9800008 
6090068 
089000 
000008 


140544 
008149 
140544 
620021 
140544 
600016 
146544 
609017 
140544 
009027 
140544 
006007 
148443 
€90020 
140544 
099973 


140544 


880013 
146544 
b0G082 
090000 
9080098 
gengnd 
eeoece 
009000 
990000 
800008 
830008 
900800 
oe0d00 
C0900 
000009 


140122 #60001 
aa0088 eN0008 
140122 000141 
680609 D00009 
149122 000162 
909800 a00000 
140122 600172 
808600 900000 
14@122 000211 
eeo0ed eo0080 
149122 990249 
800000 Bon8e8 
131716 800247 
Go0cne HNHCOe 
140122 030267 
eee088 260000 
149122 000362 
o00008 090000 
140122 000375 
ennced a00000 
pgeeng e00000 
aggces egn0ed 
eovoed 00000 
000008 Be0000 
Hooded BD0R0E 
easooe c0anad 
080009 Ha0000 
oe0g09 C60300 
oge00e Bncoed 
Goggne 3230006 


oocood 
0000800 


Figure MON-5. 


en tae iy 


oce2oco 
oooodd 


CoM TRNY 


000377 
899080 
690428 
900006 
000444 
agceea 
000465 
600000 
000506 
eogc00 
000531 
000900 
000552 
gocona 
000575 
009008 
900622 
00cd00 
800623 
co0000 
0009900 
000000 
006900 
oococe 
vocece 
Oeeaco 
000000 
osaccs 
000600 
BooncE 
Oeo0cs 
117416 


902018 
g0g00e 
002333 
000300 
002070 
o0e0e8 
002037 
p02008 
002222 
e00000° 
002041 
306900 
602255 
900000 
002474 
990000 
005003 
900300 
aso0el 
095098 
oo0900 
oacsoo 
0099008 
o0o009 
os00c0 
geao0a 
coogad 
osc0ce 
eooces 
ooc009 
oaocos 
074064 


CONFIDENTIAL 


ASTS/E Sas UPtace 
Monitor Internals 


How many modules are In the save fmage library? 


erence 


What Is the name of the first module in the save 
image library? 


What is the module's .IDENT? 


lad is the module's block offset within the 


What is the module's STB block offset (in 
octal)? 


How many symbols are in the symbol table (in 
octal)? 


What {s the virtual address inte which this 
module *loads'? 


What is the virtual. transfer address of this 
module? 
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2. 


BLOCK NUMBER 89377 


g0e/ 
820/ 
e40/ 
060/ 
196/ 
1260/ 
149/ 
160/ 
200/ 
220/ 
24a/ 
266/ 
300/ 
320/ 
340/ 
360/ 
400/ 
420/ 
440/ 
460/ 
500/ 
520/ 
540/ 
560/ 
600/ 
620/ 
640/ 
660/ 
700/ 
720/ 
740/ 
760/ 


RSTS/E SWS UPDATE 
Monitor Internals 


Using the following octal dump of a module's symbol 


table, 


003237 
886254 
806254 
006254 
006254 
086565 
606601 
607575 
007716 
907716 
007716 
007716 
019368 
019363 
610400 
812263 
812263 
912404 
012404 
012404 
012404 
012404 
012404 
812516 
812525 
012525 
814474 
814657 
014663 
014663 
614663 
014663 


071640 
812404 
021842 
053665 
075154 
138272 
139272 
671528 
127678 
130368 
130474 
131821 
971671 
107778 
157569 
124564 
125721 
127653 
127662 
127664 
138272 
130425 
131315 
073546 
062246 
062402 
@21042 
131336 
127678 
130368 
130474 
131315 


ooeena 
eeaooe 
9890000 
900800 
2940808 
a00809 
860085 
909000 
99e000 
0pe000 
900009 
500000 
0800900 
800060 
808009 
900000 
900000 
080000 
600600 
goe000 
809000 
800008 
000000 
000000 
000003 
609000 
900000 
080208 
000800 
0090006 
880006 
000008 


000014 
000037 
008171 
060002 
600103 
900206 
660612 
800856 
6601900 
600200 
880002 
061090 
900846 
666045 
809043 
177777 
000001 
608302 
800002 
800002 
000130 
609003 
000910 
600133 
000136 
900134 
600015 
176356 
OO0034 
000034 
ov0010 
900060 


806254 012265 900000 000027 
006254 615172 ao5008 090001 
866254 824327 890009 BCI022 
006254 862063 OGI200 300032 
006456 821042 ONCH0D OC0064 
896571 130272 000000 009006 
006661 136366 S00C09 GOS025 
007716 127664 OCOHGS OCOF7E 
GB7716 130272 ENCED 905208 
007716 130425 600000 601¢00 
607716 139613 OCOCOo 090200 
007716 131315 000900 601009 
010363 676463 B00CO0 00044 
010377 135608 Gn0Ned COLH42 
810402 G00008 ONC900 600041 
812263 125325 gseoces 177775 
012404 127642 QO0DCO OldTO3 
012404 127655 BO0d00 900982 


612404 127663 800008 O000R2 . 


012464 127676 900008 G00002 
012404 130368 HOOOVS 00001 
012404 130613 eo00cd 000017 
012453 821042 000900 000113 
012525 623710 O00C00 000135 
012525 062314 ocoeed C00137 
012762 045575 C004209 000934 
014574 074170 GOCIOO O5Cd00 
014663 127664 060000 cocod4y 
814663 130272 000008 C7CO72 
014663 130425 062009 209046 
614663 130613 Oc9c00 OC0014 
014734 042641 OOfCOd 630033 


Figure MON-6 
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DIGITAL 


a. What Is the mame of th 
table? 


b. What Is the value of the 


MON-14 


RSTS/E SwS$ yPsace 
Monitor Internals 


e first symbol tn the 


ee 


symbol (in octal)? 


COMPANY CONFIDENTIAL 


ber eh twl UFDATE 


Monitor internals 


FEEDBACK 


Using the octal dump of a SIL Index block, 


b. 


d. 


f. 


Sg. 


How many modules are in the save image library? 
10. or 12 (octal) 


What Is the name of the First module in the save 
image library? 


ASTS 
What is the module's . IDENT? 
; 67.064 


What {s the module's block offset within the 
SIL? 


1 


What is the module's STB block offset (in 
octal)? 


377 


How many symbols are in the symbol table (in 
octal)? 


2816 


What Is the virtual address into which this 
module 'loads'? 


@ 


— 


What {!s the virtual transfer address of this 
module? 
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2 


ASTS*E sas cprace een eue 
Monitor internats ao 2 


2. Using the octal dump of # module's symbol table, 


“HE RESISENT MONITOR 
&. What {s the name of the first symbol fn the 


table? : - At system start up Image copies of specific monitor SIL 


f and make up the ‘resident 
modules are loaded into memory Pele ers 
ABORT nonttor’. Each of these memory resident modules 


: monitor ‘phase’. 
b. What fs the value of the symbol ({n octal}? 


14 


CE 
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ASTS/E Sas cprace 
Monttor Internais 


Pigure MON-7. Resident Monitor 


MON-18 


COMPANY CONFIDENTIAL 


@8Qonn 


Sb ere: 


Vig Tle Bers 
“Bootstrap 


Driver Interrupt Dispotcks Roubines 


Yoniter Code, 


Pigure MON-8. RSTS Phase 


RITI/E SWS YROATE 
Monitecr Internals 
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4736 


AVsp 


Figure MON-9. 


usr 
System Default Crs Block. 
Tail of Hemory Control List 


ERLePY Keceiver ID Block 


Null Lun-Tore Sustern . 


“Block. 


Monitor Stack. 


Fie Sracn 


RSTS°E Sas uprace 


Monttor internals 


Date and Time Information 

Current Tob Information 

Root of Nem Control List 
MeN : 


- 


Low Memory (Pixed Locations) 


MON-2¢8 
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DATE 
TIME 
TIMSEC 
TIMCLK 
JOB 
NEXT 
JOB DA 
JOBF 
1osts 
JOBWRK 
JOBJD2 


JOBRTS . 


CPUTIM 
JOBWDB 


Figure MON-18. 


POTLSE TAG IPLETE 


“onitor Internals 


SOA 
/BIG 


Monitor Low Memory Area 


Today's date in Internal form 
Current time in internal form 
Seconds to next minute 

Ticks to next second 

Job running now 

Next job to run 


Pointer 
Pointer 
Pointer 
Pointer 
Pointer 
Pointer 
Pointer 
Pointer 


to 


to 


@ W.WIN)) 


current job data block (JDB) 
current job flags (JDB @ JDFLAG) 
current 1/0 status (JDB @ JDIOST) 
job's work biock (WRK) 

job's second jeb data block (3DS 2) 
job's run-time system block (RTS) 
current CPU time bucket (9 J2TICK) 
job's window descriptot block (WDB 


*Filled in by the scheduler 


wre i TOM EEN COMP IDENT IAL 


PSTS/E Sw3 sprace 
Monitoc tincerrsis 


JARO 
(A#Q 
Cag 
(AGL 
ASOD 
(A520 
Cage 
7756 
ACES 


R.DATA @ SMa 


aes 
S266 
1A76 
Jaa 
ane 
(Ajfe 


Figure MON-11. Null Run-time System Descriptor Block 


R.LINK 
R.NAME 
R.DEXT 
M.PPRY 
M.PNXT 
M.TSIZ 
M.SIZ 

M.CTRE 
M. PHYA 
R. DATA 
R.FILE 
R.CNT 

R.SIZE 
R.MSIZ 
R.FLAG 


No pointer to next RTS 
«RSX In RADSO 
No default extension 


No previous or next pointers In MEMLST 
No total size 

No ATS size 

Always locked in memory 

No physical address 

Nothing on disk 

Nothing in UFD 

Access and residency counts 
SWPMAX Eblled in by INIT 
Minimum legal job size 

No flags 
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wiacellaneous Code 


o” 11/68 "MED' code 

o Unibus Memory Parity Code 
o Unibus Window Mapping Code 
o Asynchronous FIP code 


o Resident Library Subroutines 


MON-2)3 
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M5500 TATe rn als 
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Wir, +o ETS list Cereus) 
Sty, tp 26 Kok, w18UsT? 
Pir, ty Cecaiver ID ust (Suoitr) 


Boe IWaeEP Hime tee (Seger) 


“Drive Sah Tolte and 
Time out Talete Crurac 


Loqjent Dame Table (Loaranty 
| Vrive Orbe tution Table 


nik Count Table Content) 


Cluster Cake Vewira Cluster size, 
Tate COiveicy [Toele (Devt) 


Etre Count Poex, Clustersion 
Tabte (oeTeae) | Tabte Cunrerud 


“pew Sor 01,21 dalle Cunrisa) 


Tk. Fee test CFceusr 
Unit Opheny Talk} Owning Job Table 
CuNrort Cusrewn) 


Starting Fon (ise)  (SATSTLD 
Sturkrg ERAN (MSE) SaTst) 
Count of eee Stecks (£98) (Sere TL) 
Count of Frere Block (U8 (F4ferHey 


RSTS.E£ 
“onttor 


Pigure MON-12. General R/W Memory 


MON-24 


as bc ate 


interne 


.4 
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PATCH Map ({PATCHS Module} - V6C change 


o 


° 


o 


ait map for mandatory and optional patches 


Sixteen words long 


Blt ‘turned on’ when patch is installed 


MON -25 
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ASTS/E£ Sas wPIATE Peete. PLUGS, Sak. SRSETE 
Monitor tinctersacs Moniter internals 


t43412 
Gi stcg. ited tf et pense 
Sere. ae 
$4562: , orasr -Reserved Gr some fast 


Ie driver 


Reserved Re To diver usage 


_ ae 


$4067: MBYERT~ Return buffers to sustern process 
Figure MON-14. Level 3 Queue Bit Assignments (L3QUE) 
Figure MON-13. PATCHS Module Layout 
$$3a1 (4 words) Monitor patches 3.1.1] through 3.1.64 
$$303 (4 words) Terminal service patches 
3.3.1 through 3.3.64 
$$305 (4 words) Pile processor patches 
3.5.1 through 3.5.64 
$$307 (4 words) Device driver patches 


3.7.1 through 3.7.64 


= : IFIDENTIAL 
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ASTS/E 


Place 
Montitor 


Tas os 
snternats 


(" 
anmen- Drea a oes ever 
Geaene. Disk caching Completion 
(reserved) 
Qaceut - Unstall big buffer wails 
Sune Unson unibus mopping Teqister 
Pree - Swap completion 
are. hie completion feontinue 
Cretecued) 
Gxse- NSP Camoletion honteve 
(reserved) ; 
are. User disk file Tho Completion a 
Oouue. Force a jp net ty be “3087 , 
Qektiwe- Kun the memory manager 


Oscuep- Schedute the scheduler 


Grerce - Torce & job net bo be "3087 


Figure MON-15. Level 3 Queue Bit Assignments {L3Que2) 
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Pigure MON~26. 


R.LINK 
R. NAME 
L.PPN 

R.MCTL 
R.KSIZ 
M. PHYA 


R.DATA 
R.FILE 
R.CNT 

L.STAT 


L.PROT 
R.FLAG 


RSTS/E Sw5 SPITATE 
Monitor internals 


Resident Library Description Block (LIB) 


Pointer to next resident library 
Resident library name In RADSO 
Resident llbrary's owning PPN 
Memory control area 

Resident library size in K words 
Physical address of start of library 
divided by 100 (octal) 

FUN and FBN of file data (1.e. the 
library) 

Name entry effset (/2) and FBN of 
UFD for file 

Attach and map counts 

Library's status 

Library's protection code 

Resident lsbrary flags 


woe 4 CIMPANY CONFISENTIAL 


RSTS/E SSeS spsacye 
Monitor tnterra:e 


| a ee Se ee Oey eee See OT 
ee ee 


(reserved) 


L8.u8 - Resident library block, 


Figure MON-17. Flag Bits (L.STAT) 


Leet = Only Lb usu atewed 

raw Wp Orvident Ubrany read fuoribe 
OF 08 ~ Den't error tog Unie evtident Ubrany 
Or. 49m - Uneena Monat meal on avit 

8 wh 

0 Wh Seca the load adarvet 


wed 


Pigure HON-18. Resident Library Flags (R.FLAG) 
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padeaie RSTS/E SWS UPDATE 
rast Moniter Internals 


Li8ist —- (Noniter Tables I © Rrsist+2) 


ws 


Figure MON-19. Monitor Tracking of ‘Added" Resident 
Libraries 
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of Sal yesaee 
Montise Incéragty 


ensitan RSTS/E SKS UPCATE 
i Monitor Internals 
System Wide Logical Name Entries 
o 


Each entry requires § words 


System wide logical name table 
° 


Each entry requires 5 words 
4 LOGAN 
Disk logical assiqament prior 
= kD explicit oxidhmott “ 
4 
G j 
Figure MON-28 epee, 
Cen d 
disk, 
LoGsy$ 


Default LB: astiqnment at stoct up 
(Chengad by explicit assiqnmant 
sa ars a 


Pigure MON-21. Logical Name Table (LOGNAM) 
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STS°S Swi vprace mestTAL RSTS/E SWS UPDATE 
oc Interrats aes Monitor Internals 


JOB RELATED STRUCTURES 


JOBCLK Table -- V6C Change 


o Word table of sleep ti 
Se Pp me for each job 


‘Oo =o Length Is job maximum + 1 
° Indexed by job number times 2 


in 


Figure MON-22. Job Data Block #1 (JDB) 


JDIOB Pointer to the 1/0 block (10b} 

JDFLG Job status flags 

JDIOST 1/0 status for job, error codes 
JDPOST Index for bit pattern to post 

JDWORK Pointer to job work block (WRK) 

JDJDB2 Pointer to job data block extension (JDB2) 
JOFLG2 More job status flags 

JDSIZN Size for job to be on next residency 
JDRTS Pointer to run-time system block (RTS) 
JORESQ Job's residency quantum 

JDMCTL Job's memory control 

JDRESB L3QUE bits to set on residency 

JDPRI Job's priority (-128. < = 127.) 

JDBRST Job's rcunnable burst 

JU312M Job's private memory maximun 

JSSeAP Job's swap parameter 


MON- 34 COMPANY CONFIDENTIAL . wines OPEN Sen PS ENT SE 


AN $ 
| Lrerosr- Cheek speear Re posting 
TF IOxy. mee te stofue Capi0tr) end 
TELSIP. Let Bax emulation cakch > posting 
Tree- “C typed by user 
eats + 2 quick °e's typed by uter 
Tepet. FPP extephon Ast needed, 
TF6o - Forcing job (no No rede) 
Treene- Reds the re eanditien | 
Jreysr- Temporary, privileges possible 
JREPC. Savafrestore ASYNE FPP content 
sR rey - Tob hos pirmanent priv's 
TFSyS« Tow has temporary priv’s ackve 
Frere. Sov 6 net yct legged in 
sree - Job Can exceed ils privoke memory mas 
Trroex- Job is not ty be swapped 


Ttseer « Special condition (check Jorres) 


Figure HON-23, Job Plag Assignments (JDPLG) 


meg 
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WANA. P 


ee Preserve the joo's content 
greeny. Faxity Faaatt 
srqun-Run entry 
© Run-& resident |i swap (load 
SESW, Run-time sugtern/ ent libracy ap (lead) 


srarac- SP stack. overflow 


IFSwPa - Swap ercoc a jp ; 
sEuuo. Kill the je> vennediakelay 


Jer - Kill Mus ied alter cleanup 


Figure MON-24. 


Job Flag Assignments (JDFLG2) -- V6C change 


wT CTYPASY CONE TIESTIAL 


ASTS/E Sas cptace p.aathe - 7 th 
Monltoe Internata ; -_ 


PD sasrs_—d Six 
F—ssunt____| ster 


$NVB 
JANAME : 


$S$Fv8 
S3FLG SS$CLUS 12 


S$UEND 4 
ee eee 7)” 
po OPONT Sawin ae 
a eae en on 
ee ee 
Dine n S eee 
ee 
Eee ee reread (Fe 
Figure HON-25. Job Data Block #2 (JDB2) eee ae eee 
ee ee ee 
J2TICK Number of clock ticks unconverted ' = 
J2cPev CPU tima collected for the job : ; ‘ scp) 
J2CON Connect time collected for the job Figure MON-26. Small Control Block (SC 
J2KCT Kilo-core-ticks collected for the job 
J2DEV Device time collected for the job : 
J2KCTH MSB of Kilo-core-ticks collected for the job S$IDX Driver Index 
J2C PUM MSB of CPU time collected for the job s$sts Status bits for file 
J2NAME : SSPT Pending transfer count 
(2 words) Job's program name SSUNT FIP unit number 
J2DRTS Pointer to default run-time system for the job : S$SIz Slze of fille Siecle 
J2Meta Pointer to job's recelver ID block (SND) SSNVB Next virtual block to read/write 
J2PPTR Large data posting pointer . SSF VB First virtual block in window 
J2PCNT Large data posting count ae Bee eae -1 
N : a : ag 
S.UEDR Mriever ointee eure a disk UFD SSUFND Name entry offset (divided by 2} and FBN of UFD 
b's wi d ipter block (wDB e@ block 
JZAPTR a to job's window descriptor i Sous Gib Pend eeteleval ulndee andcarags 
J2C PUL Inccemental CPU time calculation bucket ; 
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“Monttoe internaia 


¢ 
l DDNES-Hon-le structured 
DoRLo- User may net read 
Dowra- User may net write 
Seduen- File is open fr update. 
sedcta- Ele is tontiquens 
SCELCK - Current block ts lockask 

seturo- File is a urp | 


Seduse ~ This user has write privilege 


Figure MON-27. SS$STS 
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ASTS°E Sah srssee - 


Tee OTL 7e at UPLATE. 
Vans tor ternals 
{141.1 +}, 
eee: Wo. of blocks of 


Current block. lock 
sctre- Ble open ‘read Teqordtass’ 


sedext -the SB iS On extended SCB 


Set piw- Update Ble size and dote of last aceess 


Pigure MON-28. SSFLG 


Tete Tome ANY CINPIDENTIAL 


rIcttat ASTS/E SAS upstate 
Monitor Internals 


ae A ee] 


d 
Leetsre ed open in 
ase as 


SCHAEX - Nlaus do a real 
Setcuc- le 6 “te user _ 
Perera 


caching 
Se4csa - - User date, caching is 
Sequak ua kiad 


Figure MON-29. SSWND - Flags 
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Indexed by 
Tob no. o% 


ie] 


POTOSE Oey PLETE 
Meniioe internais 


Josten 


Pigure MON-38. Monitor Tracking of Plles Opened 
(Small Flle System) 


Write access and update information is kept on disk 
in the directory. 
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FSLINK 
FSFID 
FSPPN 
FSNAM 
€SSTAT 
FSPROT 
FSACNT 
FSRCNT 
ESAFND 
FSJFNO 
FSUNT 
FSS12M 
FSSIZL 
FSCLUS 
FSaCca 


d 
PCI 
! 
ae 

Jat 
|_Fspeor [| F$smar | 
| Fgeent | FSACNT | ve 
FEWEND — ag 

wed 

: 
per 

oe 
Se <> £5 
ee On ae | 
5 


Figure MON-31. Pile Control Block (FCB) 


Pointer to next FCB on this FIP unit 
File ID of flle (link within UFD/MFD) 
PPN of file ® 
File name and extension in RADS@ 
Status byte 

Protection code : 

Access count for normal/update opens 
Access count for read regardless opens 
FoB of first retrieval entry 

Fae of name entry 

FIP unit nunber 

Fille size MSB (number of FBN's If NFS) 
Flle size LS8 : 
Flle clustersize (WSFCB points here) 
Pointer to first WCB open on this file 
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ENTIAL 


ereptat RSTS/E CXS UPDATE 
a Monitor Internals 


eos « Tle is out of SAT 
vS.re- Ble is “placed” 
uswar- Write ocerse has bese que out 


Lar on disk) 
US. VP p- Ble open in 2. rode, 


Cab on ditt 
us.wor ~ De Nite exterding allnoed Ceantiqueus) 
US. woic~ Wo delebe or tenome allowed. 
us.vep = Gabry is ow Hed type 


us.per- Rle marked Roe deletion 
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Figure MON-53, Status and Access Control (DDSTS) 
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BBDOFF Data offset within data buffer 
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polnts 


MON-79 COMPANY CONFIDENTIAL 


[—____1@6FuN dO 
eee. eee 4 
[_1RBLgM | IRBCHN I 
{___ IRBL8 | ‘ 
/6 
fa 
¢ 
76 
Ag 
a2 
ae 
IRGEPT RG 
r_iweBertT ss es 
32 
Reneved I"4 
36 


Figure MON-56. Interprocess Request Block (IRB) 
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File utility 
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EXERCISE FOR MONITOR 


Using the map and octal dump provided, answer the 


following questions. 


1. 


2. 


Is 'J08' attached to any resident libraries? 


I— the answer {is yes, 
a. How many libraries are attached? 


b. How many APRs are being used to map the library 
or libraries? : 


Have any resident libraries been added? 


If the answer is yes, 


8. How many resident libraries have been added? 


—— 


b. Answer the following questions about the library 
which {is First In the list: 
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Resident library name 

Its project, programmer number 
Its size in Kwords (decimal) 
Its protection code 


Which resident library flags are set 


Load address of library (octal) 
Are large files sysgenned on the system? 
If the answer Is yes, go to question 5. 


Considering the file opened on channel 3 for job 
number 21: 


a. Is the file opened for update? 
b. Is the Elle contiguous? 
Cc. Does the user have write privilege? 


a. What ts the size (decima)) of the 
file? F 
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5. 


e. What Is the clustersize (decimal) of the file? 
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£. Is data caching enabled for the file? 


g- Is the data caching sequential or 
random? 


Go to question 6. 


Considering the first £ile open on the first disk 
unit of the system: 


a. What fs the Elle's PPN? 

b. What Is the flle name and extension? 
ec. Is the file placed? . 

d. Has write access been given out? 

e. Is the Elle open for update? 

£. Is the file contiquous? 

g- Is file marked for deletion? 

h. What {is the protection code? 


1. What is the access count for opens 
in normal or update mode? 


TUT 


j. What ts the clustersize? 


k. What is the octal address of the 
first WCB for the file? 


What disk types and how many units are sysgenned on 
this system? . 
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7. Considering DB2: 


a. 


b. 


Is it mounted? 
Is {t a date of last write disk? 


Are files added at the top of the directory? 


What is the current open count 
(octal)? 


What is the pack clustersize and error count? 


What is the device designator of the system 
disk? 
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va 


Single Char. 
or Second Third 
First Char. Character Character 


A gfjics A oosese A gape. 
B 665266 B 666126 8 sdp662 
c 611366 c 660176 c 6f6d63 
D b16aed o 666248 D s65064 
E 617566 E 66e3i6 E snde6s 
F 622666 F 666366 F oosses 
G 625766 G 666436 G soos? 
# 63166 # 660506 ft 666016 
i a34icé I 666555 1 s060i11 
a s3720¢ a 660628 J §66612 
a 632366 X dcee7 K oedei3 
L £45406 L oeo746 Cs L 6dse14 
4 ssésd6 M soidid 4 f68815 
N 6536n8 N 66ided N SOGALG 
° 856766 fs) 1136 ° #66517 
P 662668 P 661268 P éddd2e 
9 665ic6 Q 661256 Q s6os2 
R 6762¢6 R 661326 R Odde22 
s 673306 s 661376 s dond23 
T 76666 T édiaag T sOss24 
uv 161566 uv 661s16 u 666625 
Vv 164606 Vv ooised v digd26 ° 
w 167766 w 661636 w Oaso27' 
x 113666 x cold x 665d 36 
Y 116196 Y 661756 Y s60d31 
z 121266 zt 602626 2 666632 
$ 124366 $ g62076 $ éfgd33 
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g 135606 v 62266 g 6800 36 
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2 1ssecé 2 662466 2 sosdad 
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4 1522¢¢ 4 #62526 4 séss42 
5 155386 $ 662576 5 paosay 
6 1eeced 6 662646 6 adegs4 
7 163566 7 662716 7 PCDDEE 
8 166608 a dd2768 8 odegsG 
g 171786 9 6o3639 9 edges? 
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FEEDBACK FOR MONITOR : FEEDBACK 


Using the map and octal dump provided, answer the 


. Look at addresses 5842 and 5044. They 
following questions. : 


contain 71233 and 78533 respectively, 

which is the restdent library name 
1. Is ‘JOB’ attached to any resident libraries? No (R.NAME), in RADSO. Using the RADS® 
table, the library name is RMSRES. 


° Look at address 1026 In the dump. This is (Remember all subtraction 1s octal). 


JOBWDB in low memory which contains a pointer to 


the WDB @ W.WIN] for ‘JOB‘. 71233 
76200 - R 
o Since the value of JoBwDB {fs 8, the job has no i URE 
resident libraries attached. 191@ - M 
23 
2. Wave any resident libraries been added? Yes 23-5 
: @ 
© Cook at the map under the RAWMEM section and 
find the label) LIBLST. The address associated , 70533 
with LIBLST ts 59509. 70200 - R 
Be : 333 
© Now look st address 58580 (LIBLST) in the dump. 310 - © 
This address contains 5949. Since the value is “3 
non-zero, at least one resident library has been 23 -§ 
added on the system. The value S849 is a 6 ; 
pointer to the first resident Ilfbrary . 
description block (LIB). : Its project, programmer number _9,1) 
a. . How many resident libraries have been added? ° Look at address 5046 (L.PPN) which 
contains 980081. This value has the 
1 ; project number in the high byte and the 


programmer number in the low byte. 
o Look at address 5948 in the dump. The 


value at this address {s the link word ooogeoed /esaanesl 
for the resident library description SS 
block. Since the word contains a @, 8 1 


there is only one LIB block in the list. 
, Its size in Kwords (decimal) 23kw 
b. Answer the following questions about the 


library which is first in the list: o Look at address $056 (R.KS12) which 


contains 1827 in octal. The low byte of 
this word is the size of the resident 
library. 


Resident library name RMSRES 
27 (in octal) = 23 (In decimal) 
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FEEDBACK 
Its protection code 42 
° Look at address $074 which contains 
@25208. The library status flags are in 
the low byte and the library protection 
code is in the high byte. 


L.PROT L.STAT 
a8lelgia/iagoosed 


52 foctal) = 42 (decimal) 


Which resident ifbrary fiags are set. Save 
the load address. 


o Look at address 5876- Rs FLAG) which 
contains 040009. 


$119 9)6 6100 les 60 )eess6] 
een 
eat 
Unverd, 


PP.tub- Only L user allowed 


oot. Uap esdert WWorery read/write 
Pena. Dent eee Vag His texdent Bbrary 
PF.REM- Unceraitanal Coneval on enet 
Voted 
PFS » Sewce the load adarces 


Used 


Figure MON-78. 
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FEEDBACK 
Load address of llbrary (octal) 13206908 


° Look st address 5968 (M.PHYA) which 
contains 13200. This is the actual 
physical address at which the Library 
will load divided by 109 octal. 


Are large files sysgenned on the system? Yes 


° Look at the map. Since the section SYDLRG 
appears in the map, this {s a large flle system. 


Considering the first file open on the first disk 
unit of the system: 


Note 
To find the address of the FCB for the 
first fille: 


° Look at the map under the RAWMEM 
section and find the label FCBLST. 
The value 52352 fs the address of the 
FCB table. 


Starting at address 52352 in the 
dump, scan for the first non-zero 
word. This is at address $2366 which 
contains 13746. 


The 13748 Is the address of the FCB 
for the ficst Elle. 
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a. What is the file's PRN? (40,40) 


o The File's PPN {is the third word in the FCB. 
At address 13744 ts the value 240508 which fs 


the PPN. 
PROJ PROG 
091010090 /88181000 
Ne Res 
58 50 


Note 


59 foctal) = 40 (decimal) 


b. What is the filename and extension? DNDA14.TMP 


o The f£ilename and extension aré stored in 
RADS® format starting at address 13746. 


° The values 15464, $472 and 77439, converted 
from RADS@ using the table grovided, produce 
DNDA14. TMP, ‘ 
ec. Is the file placed? No 


o Look at address 13754 which contains 36024. 
The low byte of the word is the FSSTAT byte. 
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F4eROT egsrar 


. - 
e 


lee ttyts ese sere 1,4 4 
| locsiefeacis ast of aor 


whem. Rta rg paced, 
8. wer Late occran hag hong oat 
920 fle epen jn epdabe made 
et mes Ce eventing Pour d Ceentgnen) 
Awe. Be Belata wr f- ane aNeueal 
Nef. ule catey is an WED Rape, 
t.00. = Bla mashed Cor Aateden 


TdLectal) 2tB (decimal) 


Figure MON-79. 


Ras write access been given out? Yes 
Is the file open for update? No 
Is the file contiguous? Yes 
Is the file marked for deletion? No 
What ts the protection code? 63 


o Look at the high byte shown In ¢ (FSPROT) 
above. The 74 octal Is 60 decimal. 


What is the access count for opens in normal or 
update mode? 


° Look at address 13756 which contains otecol. 
The low byte of the word (FSACNT) contains 
the access count for normal or update mode. 


What is the clustersize? 8 


° Address 13744 contains the clustersize. 


What is the octal address df the first KCB for 
the file? 17748 
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t.) Address 13776 contains the WCB address. 


6. What disk types and how many units of each are 


sysgenned on this system? 


Disk Number 
pos 2 
DK 2 
DA 2 
DR 2 
0B 3 


There are two ways to find the answer. 


a. 0a Look at the .ABS. section of the map for 
symbols of the form CNT.xx where xx Is a 
disk type. (1.e. CNT.D8) 


° The value of these symbols is the number of 
units sysgenned. 


b. o Look at the map under the T8L section for 
the label DEVCNT which contains the address 
of the device count table 73310. 


° Starting at address 73318 the first nine 


words contain: -l, <-ly 1, 1, -le 1, ~ly le | 


2. These are the highest valid unit numbers 
on this system for each disk type supported 
by RSTS/E. 


o Referring to the DEVNAM table in the module, 
the ftrst nine words cepresent the disk 
types supported by RSTS/E (DC, DF, DS, DK, 
DL, DM, DP, DR, DB) 


DIGITAL RSTS/E SWS UPDATE 


Monitor Internals 


FEEDBACK 


° Since the entries in DEVNAM and DEVCNT 
. correspond directly to each other: 


WHEN GONNA 


Considering DB2: 


To answer this question you must first get the 
UNTCNT entry for DB2: on this system, To get this 
information: 


° Look at the map under the TBL section for the 
Jabel DEVPTR which contains 73362, the address 
of the device pointer table. 


o Starting at address 73362 count in 9 words, The 
valve (52242) is the address in the UNTCNT table 
for DB@: 


o Starting at address 52242 count in 3 words (this 

{s the offset from DB@: to DB2: in the UNTCNT 

‘table). The value is 994017, which Is the unit 
count status information for DB2: 
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FEEDBACK 


FuN(octal) |  FUN*2 fecta)) 


Loc.enr - Open Caccess) count 
uc.t0P ~ Link fe hp 
uc.wle - Mounted write locked 
L ve. dew = Date last write 
| veewFS- Neunted non-Cle thructured 
ve uch Unit is locked 
ve. PRic Mounted private. 


L veut = Unik ts not mounted, 
Figure MON-88. 


The order of the disks is very 
important. They must be in the order in 
which they appear in the DEVNAM table. 


a. Is {ft mounted? : Yes Also the FUN begins with @. 
b. [Is it a date of last write disk? Yes 


c. Are €lles added at the top of the 


‘ ° Therefore, the FUN for DB2: {s 12 and 
directory? No; FUN*2 is 24. 
d. What is the current open count . b. Using the FUN*2 for 0B2:, offset into the 
{octal}? 17 UNTCLU table to get the pack clustersize in 
: the low byte and the error count in the high 
e. What is the pack clustersize and error byte. 
count? 8 
o Look in the map under the RAWMEM section 
8 for the label UNTCLU which contains the 
value 52276. This is the address of the 
To answer this question you must: 


UNTCLU table. 


a. Determine the FIP unit number*2 for DB2: on 


(.) To offset Into the table by FUN*2, add 
this system. . 


24 to 52276 (remember to do octal 


addition) to get the address 52322. 
o Using the Information in question 5, you 


know that the configured disks are: o ook at address 52322 in the dump «hich 


contains #00010. 
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UNTERR UNTCLU 
G8ad0G0G /60061900 


8 19 


o The pack clustersize=19 {octal} which is 
@ In decimal. 


o The error count {fs 9. 
What is the device designator of the system disk? 
DB2: 


To answer this question, you must remember that the 
word just before the DEVPTR table points to the 
entry in the UNTCNT table for -the system disk (see 
the module). 


o Since the address of the DEVPTR table is 73362 
(see question 7), look at address 73368 which 
contains 52246. 


o Starting an’ address 73362 (DEVPTR) scan the 


ficst nine words for the number which is, the 
closest to but not greater than 52246. : 


The ninth word (52242) is the one you're looking 
€or. 


o From question 7, this entry pofnts from the 
DEVPTR table into the UNTCNT table for DBO: 


0 Therefore: 
§2242 —————~ Dea: 


§2244 ————_——> DB l: 
52246 ———————-» DB 2: 
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Data Caching Internals 


. INTRODUCTION 


The internal structures and operaticns of caching 
on RSTS/E aids in understanding what actions are taken 
when a user requests disk information. 


Knowing how caching works enables you to determine: 
e Whether a file should be cached 


° How a fille should be cached 
e What the cache cluster size should be 
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This page is for netes. : 
MONITOR STRUCTURES - WITHOUT SYSGENNING DATA CACHING 


e Only directory caching (FIP buffering) 
_ @ Defaults at startup time 


- Cache enabled 


- Cache clustersize of 1 


Use monitor buffer pool 


- Total number of cache clusters is 65535 
(unlimited) 


- Total number of cache clusters for directories is 
65535 (unlimited) 
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CHENXT. 
CRE Pav 


tr. * 
SHEA $SCACH:: 


RSTRTN 


REFLAG 
CHEL IG 


CHERST** 
‘CHENUM 
CHENU 


* FILLED IN BY INIT 
*@ ONLY IF STATS ARE GENNED 


Pigure CAC-1, CHECTL AREA OF MONITOR (no data caching) 


cAC~-4 : COMPANY CONFIDENTIAL 


CHECTL 
CHETIC 


CHENXT 
CHEPRV 
CHE PAR 
CHETAG 
CHEUSM 


CHELIM 
CHEF LM 


SAVKA6 
RSTRTN 
REF LAG 
CHEL 3Q 


CACHEQ 
POS 


HIT 
CHERST 


CHENUM 
CHENUE 


(word) 
(word) 


(2 words) 
(2 words) 
(2 words) 
(2 words) 


PETS/E UPIATE 
Data Caching Internais: 


499-——» cache enabled 

@——= cache disabled 

j——» charge cache time 

@—» no charge 
Pointer to “first” cache tag in list @+2 
Pointer to “last” cache tag in list @ 4 8 
PARG value for extended cache tags (INIT) 
List of usable extended cache tage (INIT) 


. -l——»monitorc pool (INIT) 


§9—» no use of monitor pool 
Limit of total numbers of extended cache 
tags 
Limit of number of extended cache 
directory tags 
Saved KISAR6 
*“Restart” return address 
"Restart" flag {SP stack valve) 
Pointer to cache completion queve reot 
(CACHEQ) 
Caching level 3 queve bit (QCACHE) 
Caching completion queve root 
Total possible number of hits 
Total possible number of FIP hits 
Total number of hits 
Total number of FIP hits 
Number of times cache restarted 
Number of monitor buffer cache elements 
Number of extended pool cache elements 
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SIGs TAL ASTS/E wPrace 
Data Caching intercaia 


Pointer to cache statistics (POS) * 


Dana 


* Only if STATS are genned r 


Figure CAC-2,. STSTBL entry for statistics (no data caching) 
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tal ; ASTS/E YPCATE 
Data Caching internals 


Cache tags 


e Identify directory blocks currently in the cache 
clusters. 


e Keep track of time of last reference. 


e A deubly linked list with head and tall pointers in 
CHECTL. 


e Exist in XBUF and/cr monitor pool space. 


e XBUF tags created by INIT at start up. 


| CH.NXT 
2 CH. PR 
4 'CH.MSB | 
6 
10 CH.TIM 
12 CH. DAT 

CHSSIZ - Size of cache tag in bytes 

Figure CAC-~3. Cache Tag 

CH. NXT Pointer to next @ CH. PRY IE two high 


bits set, tag in 
XBUF 

CH.PRV Pointer to previous @ CH.NXT 

CH.UNT Unit number of block 

CH.MSB Block's FAN MSB 

CH. LSB Block's FBN LSB 


CH.TIM Time of last reference 


- CH. DAT Pointer of cached data block 
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DIGITAL 


‘ 
ASTI © Lesasy 


Data Caching tncersa.g 


Pigure CAC-4, Cache Tag List ‘ 
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DIGITAL . PSTS/E YPORTE 
Data Caching Internals 


MONITOR STRUCTURES = DATA CACHING SYSGENNED 
. e Directory and Data Caching available 
e Defaults at startup time 
- Cache enabled 
~ Data caching available through MODE 
~- Cache cluster size of 4 


- Total number of cache clusters to be used is 
65535 (unlimited) 


~ Total number of cache clusters for directories is 
65535 (unlimited) 


- Total number of cache clusters for data {s 65535 
(unlimited) 


@- All cache tags are in XSUF , 
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CIStvaAL ASTSeE sriace 
Data Caching tnzernats Dist TAt pe eae tli 


Data Caching Internals 


CHECTL 
CHETIC 122 
CHENXT 124 
CHEPARS SSCACHen 130 
@ - No monitor buffers used* 134 
CHEWTG* 136 HRS.RH** 
1490 
142 DIR.RH** 
144 
146 CHERST** 
Pie CWE BS ES ed $$casz iba 
CHESHF 152 
el 154 
CHEDIC® 156 
SAVKA6 - : 166 
Po RSTATN 162 
Po CREFLAG 164 
166 
pCR XB 176 ae ae 
CHWTLI 172 ; : 
CHWRTQ | 176 
CHROLJ 209 
202 
: 204 RDS.AX** 
206 
; 219 
212 
216 
222 
226 
232 : 


** Only {£ STATS Genned 


Figure CAC-5. CHECTL Area of Monitor (data caching) (cont.) 


* Filled In by INIT 


Figure CAC-S. CHECTL Area of Monitor (data caching) 
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CRECTL 
CHETIC 


CHENXT 
CHEPRV 
CHEPAR 
CHETAG 
CHENTG 
CHELIM 


CHEFLM 
CHEDLM 


~ CHEMOD 


CHEBS2Z 
CHESHF 


CHEBIC 
SAVKA6 
RSTRTN 
REE LAG 
TMWQUE 
CHLF XB 
CHWTL3 


CHWATQ 
CHRDL3 


CHREDQ 
FAKDSQ 
RDS.xC 
DIR.CN 


HAS RA 
DIALRH 
CHERST 
CHENUE 


word) 
word) 


word) 
word) 
word) 


word) 


words) 
words) 


words) 
words) 


ASTS/E cerace 
Data Caching Internat, 


490—» cache enabled 
8—» cache disabled 
l—* charge cache time 
9—= no charge 
Pointer to £irst tn list @+2 
Pointer to last in list @+¢ 
PAR6 value for extended cache tags 
List of usable extended cache tags 
List of usable extended cache tags 
Limit of total number of extended cache 
tags 
Limit of number extended cache directory 
tags 
Limit of number of extended cache data 
tags 
@—» No data caching 
1—* open mode caching 
~1—-» cache all data 
Slze of a cache cluster in blocks 
Amount of shift to divide by cluster size 
Mask to round FBN down to cache cluster 
Complement of above mask 
Saved KISARS 
“Restact" return address 
“Restart” £lag (SP stack value) 
Queue for writes awaiting free write tag 
Time of last fallure to allocate buffer 
Pointer to caching queue root for writes 
(CHWATQ) 
Level 3 queue bit for cache (QCACHE) 
Caching queve root for writes . 
Polnter to caching queve root for reads 
(CHREDQ) 
Level 3 queve bit for cache {QCACHE) 
Caching queue root for reads 
Fake DSQ for handling cross cluster 
transfers 
Number of disk transfers which are cached 
Number of above which are directory 
transfers 
Number of cache hits , 
Number of above which are directory hits 
Number of times cacher restarted 
Number of extended pool cache elements 
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CHFCNT 
CHDCNT 


DAT.CN 
DAT.RH 
RDS.NC 
RDS.CI 
ROS.LX 
RDS.RX 
RDS.SR 
WTS.NX 
WTS.CH 
CAN.CH 


HIT.CH 


words) 
words) 
words) 
words) 
words) 
words) 
words) 
words) 
words) 
word) 


word) 


’ word) 


word) 


PSTS/E UPDATE 
Data Caching Internals 


Count of directory cache tags 

Count of data cache tags 

Data transfers which were cached 

Cache hits on data transfers 

Transfers which are not cached 

Fraction of above due to cache installs 
Large transfers cut up into segments 

Large transfers not cached because no tags 
Segment reads produced when cut up 

Total write transfers 

Tags hit by writes 

Pointer to STATS area for directory reads 
(DIR.CN) i 

Pointer to STATS area for data reads 
(DAT.CN) 

Pointer to STATS area for directory hits 
(DIR.RH) 

Pointer to STATS area for data hits 
(DAT.RH) 
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ASTSE/E cpsce 
Data Caching internase Drtetas 


Cache Tags 


. ° Identify directory and data biocks currently In 
cache clusters 


e Keep track of time of last reference 


e A doubly linked list with head and tall pointers in 
CHECTL 


e Exist only in xBUF 


° Created by INIT at startup 


* Only If STATS are genned 


Figure CAC-6. STSTBL entry for statistics (data caching) 
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TRISTE COVERY TOSPIDENTIAL 


RSTS/f uPlace 2 MES SOTAS RETS/E UPLATE 
oe Caching internets Data Caching internals 


Write Tags 


e® Used to store DSQ information while disk is 
% . transferring data to the cache 


WT.CTP 
WT.MSC 


Figure CAC~8. Cache Write Tag 


6 
2 
Figure CAC~7. Cache Tag : 
1 
1 
1 


CH.NXT Pointer to next @ CH.PRV 


CH.PRV Pointer to previous @ CH NXT 
CH.UNT Unit number of block 


CH.MSB) Block’ s FBN MSB - Ailes eeeg i rd oe Mree dah sree Agcy ee 
CH.LSB Block's FAN LSB eee, saeee eae 


WT.CNT Saved DSQCNT 


. WT.L3 Saved DSQL3 
CH.DAT Pointer to the cached data block | WT COF ave nae 


% Saved transfer's block offset into cluster 
‘ WT.CHM Saved cache mode of transfer 
CH.BLS Pointer to DSQ's waiting on tag WT.CTP Saved pointer to cache tag 


: WT. D Ss 
CH.TYP Type pointer (data or directory) MABeG. =Baved DS UMse 


CH.TIM Time of last reference : 


CAC-15 COMPANY CONFICENTIAC aaoeta COMPANY CONFIDENTIAL 


Sigitan ~ RTS. 8 vesace 
Cata Caching internals 


Cache tags in use 


CEENX 
CHEPRV 


Available cache tags 


Available cache write tags ‘ 


List of write tags 
{waiting on disk completion 


Figure CAC-9. Tag List (data caching) 


CHETAG 
CHEKTG 


CEXRTQ 
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HOW CACHE VIEWS A DISK 


BETS/E CPIATE 
Data Caching Intercais 


Always divided {nto cache clusters (cc) 


starting at DCN 1. 
DCN @ 


MOM tL 
cc cc ce ec ce 


Note 


Cache will always transfer an entire 


cache cluster. 


If there {s no room in the cache a 
normal disk 1/0 to user buffer is done. 


TRIAD 


COYPENY CONFIDENTIAL 


DIGITAL : ASTS/E SPLAtTe ee : 
Dats Caching Incernals Data Tachin 


e When a cache cluster equals a pack cluster (pc) e When a cache clutter is smaller than pack cluster 


DCN 8 
Pec Pc ec pc- PC Pc 


DCN @ 
Pc . pc PC Pc 
eeee PF cmemntieeenest 
cco cc cc cc cc. cc eves 
cc cc cc ce ce cc 


e@ When a cache cluster is larger than 4 pack cluster 


DCH 9 . 
pc PC PC PC. Pc pc 
cc ec Lo 03 ce 
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"How CACHE MOVES DATA INTO MEMORY 


Case 1: 


ASTS’E uPsace 
Data Caching Internats 


® Cache Cluster = Pack Cluster = File Cluster = 1 


Note 


No Sequential Caching 


e User Request - Read block 2 of a file 


1/0 Buffer 
(512 bytes) 


pe a 
cul 
ce eee 
“- 
_ 


cu 2 
(of Efle) 


3lock 2 
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eoeteas Sct oR LFIRTE 
arg Dats “att ..g internals 
Case 2: @ Cache cluster > Pack Cluster = file cluster 

2 o User Request - Read Block 2 of a Eile in Elle 


cluster 2 


e 


pc pc ec PC 


<0 ee @ 
os eS a 
aN 


cc ce 


CACHE 
in 
Memory 


I/O Buffer 
($12 bytes) 


- Block requested 


Note 


Since an entire cache cluster is read 
into memory, part of the data {s not 
useful to the user. 


Thredd 
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OSSITAL RSTS/E Uplate 
Osta Caching Internats 


Case 3: e@ Cache Cluster > Pack Cluster « File Cluster 


e User Request ~ Read Flle Clusters 1 and 2 


PC PC Pc PC PC 


Disk ae —_ hey 


“ a 
No ce ~ 
er ce ye . So 
CACHE 
in { CLi1 
-Memory 
a” 
- \ - wae 
\ \ a ria 
\ Soe a 


1/0 Buffer 
(=2 E1le clusters) cLi | ch2 


Note 


Cache makes two disk reads to satisfy the 
request. , 


